Saltar a contenido

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

  1. Revisa tu plan. La API está disponible en Plus y Pro.
  2. Solicita tus credenciales a soporte. Ver Solicitar acceso.
  3. Comparte la documentación técnica y las credenciales con tu equipo de sistemas. Ver Documentación técnica.
  4. Revisa los envíos en Reportes → API para comprobar que todo funciona.

Próximos pasos