Saltar a contenido

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:

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.


Próximos pasos