Tu sistema manda, el nuestro responde
No hay conector que mantener ni calendario nuestro que esperar. Tu sistema crea leads, pide comparativas y lanza altas contra nuestra API, y recibe un evento firmado cada vez que algo cambia. Lo que construyas es tuyo.
Qué significa «API friendly»
Tres cosas concretas. Que todo lo que hace una persona en el CRM se puede hacer por API desde tu sistema, con las mismas reglas. Que no tienes que preguntar: cuando algo cambia, te lo decimos nosotros con un webhook. Y que la API es un contrato: documentada, versionada, y sin campos que aparezcan o desaparezcan sin aviso.
El resultado es que un canal con un CRM propio, una web propia o un ERP no tiene que cambiar de herramienta para trabajar con nosotros.
Qué puede hacer tu sistema
| Acción | Qué obtienes |
|---|---|
| Crear un lead | La oportunidad nace en el CRM con tu canal de entrada y, si lo indicas, asignada a un comercial. |
| Pedir una comparativa | Con una factura o un CUPS. Devuelve las tarifas del catálogo del canal contra la actual, con el ahorro descompuesto. |
| Lanzar un alta | Con la comparativa aceptada o directamente. Entra en tramitación y desde ahí te llegan los eventos. |
| Consultar el estado | De un lead, de un expediente o de tu cartera, con el motivo si algo está parado. |
| Consultar liquidaciones | Lo devengado, lo liquidado y lo pendiente del canal. |
Algunas de estas capacidades entran por fases. En la demo te decimos cuáles están abiertas hoy y con qué límites; no publicamos aquí una lista que caduque.
Webhooks: te avisamos nosotros
Cada cambio relevante —lead creado, comparativa lista, propuesta aceptada, alta enviada, alta rechazada con su motivo, contrato activado, liquidación cerrada— dispara un evento a la URL que hayas registrado.
- Firmados. Cada evento lleva una firma con el secreto de tu canal; compruebas que viene de nosotros y que no se ha tocado por el camino.
- Reintentos. Si tu endpoint no responde, reintentamos con espera creciente durante horas. Nada se pierde por un despliegue tuyo a mala hora.
- Y si sigue cayendo, una persona. El evento no se descarta en silencio: la oportunidad aparece como tarea para alguien de tu equipo, con el evento pendiente adjunto.
- Idempotentes. Cada evento tiene un identificador; si lo recibes dos veces, sabes que es el mismo.
Autenticación y entornos
- Claves por canal, una de producción y una de pruebas. Se enseñan una sola vez al crearlas; después solo se ven los últimos caracteres.
- Con caducidad. Las claves expiran y se rotan desde el propio CRM, sin pedírnoslo.
- Entorno de pruebas con datos inventados, para que tu equipo construya sin tocar clientes reales.
- Ámbito por canal. Una clave solo ve los datos del canal que la creó. No hay clave que vea a todos.
Lo que nunca sale por la API
La API devuelve una proyección: un conjunto de campos declarado uno a uno, que es el mismo que leen el bot de mensajería y el agente de voz. Se declara qué sale, no qué se oculta, y por eso un campo nuevo en la base de datos no aparece en ninguna integración hasta que alguien lo añade a propósito.
Fuera, por diseño: el margen del canal, las comisiones de otros canales y el IBAN. Ni con la clave de producción, ni con la de pruebas, ni pidiéndolo.
Cómo empezar
Pide la clave de pruebas desde el CRM de tu canal y registra la URL de tu webhook.
Crea un lead y pide una comparativa con un CUPS de prueba. Verás llegar los dos primeros eventos.
Lanza un alta y sigue el expediente hasta el contrato activo, con sus eventos. Cuando lo tengas, cambias a la clave de producción.
FAQ
¿Tenéis documentación pública de la API?
La documentación se entrega con la clave de pruebas, junto con el entorno de pruebas y una colección de ejemplos. No está publicada en abierto porque parte de la API entra por fases y preferimos que lo que leas sea lo que puedes usar hoy.
¿Puedo conectar mi CRM sin programar?
Para HubSpot, Salesforce y Pipedrive hay un espejo del expediente que no requiere desarrollo por tu parte: el expediente aparece en tu CRM con los mismos campos que devuelve la API. La API es para cuando quieres algo a tu medida.
¿Qué pasa si cambiáis la API?
Está versionada. Los cambios que rompen algo van en una versión nueva y la anterior sigue funcionando un tiempo anunciado. Añadir un campo nunca rompe nada, porque tu sistema solo lee los que conoce.