Documentación técnica¶
La documentación técnica de la API explica cada llamada en detalle: qué datos recibe, qué devuelve y ejemplos. Está pensada para tu equipo de sistemas o para el proveedor que haga la integración.
Documentación API v1 Documentación API v2
Versiones¶
Las dos versiones están vigentes y se pueden usar al mismo tiempo.
| Versión | Para qué se usa |
|---|---|
| v1 | Envío de plantillas de WhatsApp, SMS, códigos de verificación y automatizaciones; cobranza (importar y actualizar deudas, gestiones); alta y estado de usuarios; consultas de contactos, oportunidades y actividades; creación de oportunidades. |
| v2 | Administración completa del CRM: contactos, oportunidades, actividades, etiquetas, grupos, equipos, pasos del embudo, tipos de actividad y tipos de documento. Incluye la estructura de los eventos de Webhook. |
Consulta la sección Qué puedes hacer con la API para ver cada acción y su versión.
Datos básicos¶
| Tema | Detalle |
|---|---|
| Servidor | https://megasistema.megadigital.com.py:5000 |
| Tipo de API | REST. |
| Parámetros | En las llamadas GET van en la URL (query, clave-valor). En las llamadas POST van en el cuerpo en formato JSON. |
| Autorización | Token de tipo Bearer, enviado siempre en el encabezado (header) de cada llamada. |
| Obtener el token | Se obtiene autenticándose con los datos que entrega soporte (claveApi, empresaId y usuario). Las mismas credenciales sirven para las dos versiones. En la v1 es la llamada Usuario → Autenticar; en la v2, Autenticación. |
Credenciales
Si todavía no tienes la claveApi, solicítala a soporte. Ver Solicitar acceso.
Límites de los envíos¶
Los envíos de plantillas por API siguen las mismas reglas que los envíos desde la Suite:
- La plantilla debe estar aprobada por Meta. Ver Crea plantillas de WhatsApp en Meta y Plantillas.
- Aplican los límites de envío de tu portafolio empresarial de Meta. Ver Revisa tu portafolio empresarial.
- Tu cuenta de WhatsApp debe tener un método de pago activo. Ver Configura el método de pago de WhatsApp.
Si un envío falla, el motivo aparece en la columna Detalle Estado Mensaje del Histórico de Envíos.
Recibir avisos de Centria (webhooks)¶
La API v2 documenta qué datos envía Centria cuando ocurre un evento sobre un contacto (creado, actualizado o eliminado) o una oportunidad (creada, actualizada o eliminada). La dirección que recibe esos avisos se configura en Configuración → Integraciones → Webhook. Ver Webhook.