API de Centria¶
La API de Centria permite que otro sistema de tu empresa (tu ERP, tu tienda online, tu web, tu app o una herramienta de automatización) trabaje con Centria sin que nadie entre a la Suite. Por ejemplo, tu sistema de facturación puede enviar un recordatorio de pago por WhatsApp o tu web puede crear una oportunidad cada vez que alguien completa un formulario.
Disponible en los planes Plus y Pro
La API está incluida en los planes Centria Plus y Centria Pro, sin diferencias entre ambos. Si tu empresa tiene el plan Centria Esencial, puedes cambiar de plan desde Configuración → Mis datos de facturación. Más información en Mis datos de facturación.
Esta guía está pensada para quien decide qué conectar. La parte técnica (cómo se arma cada llamada) está en la Documentación técnica, que puedes compartir con tu equipo de sistemas o con el proveedor que haga la integración.
Qué puedes hacer con la API¶
La API tiene dos versiones y las dos están vigentes: la v1 se usa sobre todo para enviar mensajes, cobranza y consultas, y la v2 para administrar los datos del CRM. Tu sistema puede usar las dos a la vez.
Enviar mensajes¶
| Acción | Versión | Dónde ves el resultado |
|---|---|---|
| Enviar plantillas de WhatsApp aprobadas a un contacto. | v1 | Reportes → API → Histórico de Envíos |
| Enviar SMS. | v1 | Reportes → API → Histórico de Envíos |
| Enviar códigos de verificación de un solo uso (por SMS o WhatsApp). | v1 | Reportes → Autenticación |
| Iniciar una automatización para un contacto. | v1 | Se consulta por la API (listado de envíos de automatizaciones). |
Los envíos por API tienen las mismas reglas que los de la Suite
Enviar una plantilla por API es igual que enviarla desde Centria: la plantilla debe estar aprobada por Meta y el envío queda sujeto a los límites de tu portafolio empresarial y al método de pago de WhatsApp. Revisa Plantillas y Configura el método de pago de WhatsApp.
Contactos y oportunidades¶
| Acción | Versión |
|---|---|
| Consultar y buscar contactos (por ID, documento o razón social). | v1 y v2 |
| Crear, editar y eliminar contactos. | v2 |
| Asignar y quitar etiquetas y grupos a un contacto. | v2 |
| Consultar y buscar oportunidades (por ID, fecha, contacto o usuario). | v1 y v2 |
| Crear oportunidades. | v1 y v2 |
| Editar y eliminar oportunidades. | v2 |
| Consultar actividades (por ID, fecha, contacto, usuario u oportunidad). | v1 y v2 |
| Crear, editar y eliminar actividades. | v2 |
Configuración del CRM¶
Con la v2 puedes consultar, crear, editar y eliminar:
- Etiquetas y grupos de contactos.
- Equipos.
- Pasos del embudo y su relación con los tipos de oportunidad.
- Tipos de actividad.
- Tipos de documento.
También puedes listar los vendedores de tu empresa.
Cobranza¶
| Acción | Versión |
|---|---|
| Importar deudas en formato Excel o JSON, sin cargar el archivo a mano. | v1 |
| Actualizar una deuda (por ejemplo, cuando el cliente paga). | v1 |
| Consultar las gestiones de cobranza realizadas. | v1 |
| Consultar las automatizaciones de cobranza disponibles. | v1 |
Usuarios¶
| Acción | Versión |
|---|---|
| Crear usuarios en Centria. | v1 |
| Activar o desactivar un usuario. | v1 |
Ejemplos de uso¶
| Necesidad | Cómo ayuda la API |
|---|---|
| Avisar al cliente que su pedido salió | Tu tienda online envía una plantilla de WhatsApp en cuanto se despacha el pedido. |
| Recordar cuotas o vencimientos | Tu sistema de cobranzas actualiza las deudas en Centria y envía el recordatorio. |
| Verificar el teléfono de un cliente | Tu web o tu app pide a Centria que envíe un código de verificación por SMS o WhatsApp. |
| No perder leads de la web | Tu formulario crea el contacto y la oportunidad en Centria, listos para que el equipo los atienda. |
| Mantener un único registro de clientes | Tu ERP crea y actualiza los contactos en Centria, con sus etiquetas y grupos. |
API, Webhook o Rutas: ¿cuál uso?¶
Centria tiene tres formas de conectarse con otros sistemas. Se diferencian en quién inicia la comunicación:
| Herramienta | Quién inicia | Ejemplo |
|---|---|---|
| API | Tu sistema le pide algo a Centria. | Tu ERP envía un recordatorio de pago por WhatsApp. |
| Webhook | Centria le avisa a tu sistema cuando pasa algo. | Centria avisa a tu ERP cuando se crea una oportunidad. |
| Rutas | Centria consulta a tu sistema. | Un bot consulta el saldo del cliente en tu ERP. |
Se pueden combinar: por ejemplo, tu web crea oportunidades por API y Centria le avisa por Webhook cuando el equipo las actualiza.
Cómo empezar¶
- Revisa tu plan. La API está disponible en Plus y Pro.
- Solicita tus credenciales a soporte. Ver Solicitar acceso.
- Comparte la documentación técnica y las credenciales con tu equipo de sistemas. Ver Documentación técnica.
- Revisa los envíos en Reportes → API para comprobar que todo funciona.