Bienvenido a la API de Platica
La API de Platica.mx te permite integrar agentes de inteligencia artificial en tus aplicaciones de manera sencilla y escalable. Con nuestra API REST podrás automatizar conversaciones, gestionar clientes y aprovechar el poder de la IA conversacional.
URL Base
Todas las peticiones a la API deben realizarse utilizando la siguiente URL base:
https://api.platica.mx¿Qué puedes hacer con la API?
Gestionar Agentes — Crea, configura y administra agentes de IA personalizados para diferentes canales de comunicación.
Administrar Clientes — Mantén un registro actualizado de tus clientes con campos personalizados y etiquetas.
Darles Herramientas — Conecta servidores MCP o cualquier API HTTP y decide qué puede llamar cada agente.
Conversar con Agentes — Integra un chat síncrono con tus agentes de IA y conserva el contexto entre turnos.
Enviar Mensajes — Inicia conversaciones usando plantillas de WhatsApp aprobadas y envía mensajes personalizados.
Consultar Conversaciones — Accede al historial completo de conversaciones y su estado en tiempo real.
Gestionar Campañas — Crea y administra campañas de comunicación masiva con audiencias segmentadas.
Organizar con Etiquetas — Clasifica contactos y conversaciones con etiquetas manuales o aplicadas automáticamente por la IA.
Recibir Notificaciones — Configura webhooks para recibir eventos en tiempo real sobre tus conversaciones y clientes.
Recursos disponibles
| Recurso | Descripción |
|---|---|
| Autenticación | Configura tu API Key para autenticarte |
| Agentes | Crea y administra agentes de IA |
| Herramientas | Conecta servidores MCP y APIs, y asígnalas a tus agentes |
| Canales | Consulta y administra los canales de tus agentes |
| Clientes | Gestiona la información de tus clientes |
| Campos personalizados | Define datos adicionales en tus clientes |
| Chat | Habla de forma síncrona con un agente desde tu aplicación |
| Mensajes | Envía mensajes y plantillas |
| Plantillas | Consulta plantillas de WhatsApp |
| Conversaciones | Consulta el historial de conversaciones |
| Campañas | Crea y administra campañas de comunicación |
| Etiquetas | Clasifica contactos y conversaciones con etiquetas |
| Estadísticas | Monitorea consumo, mensajes, conversaciones y autonomía |
| Webhooks | Configura notificaciones en tiempo real |
| Errores | Referencia de códigos de error |
Primeros pasos
Para comenzar a usar la API, genera tu API Key directamente desde el dashboard de Platica en Configuración → API Keys, sin necesidad de contactar al equipo de soporte.
Una vez que tengas tu API Key, dirígete a la sección de Autenticación para aprender cómo incluirla en tus peticiones.