Si tu negocio ya tiene un sistema propio (tu ERP, tu sistema de facturación, tu tienda en línea), puedes conectarlo a Conversa para que trabajen juntos. Este artículo te explica qué se puede hacer y qué decisiones te tocan a ti. La parte técnica la hace tu programador o tu proveedor con la referencia que está al final.
Hay tres piezas, y cada una va en una dirección distinta:
| Pieza | Quién llama a quién | Para qué sirve |
|---|---|---|
| API | Tu sistema llama a Conversa | Mandar avisos por WhatsApp y consultar resultados |
| Webhooks salientes | Conversa le avisa a tu sistema | Enterarte en tu sistema de lo que pasa en el chat |
| Conectores | El bot le pregunta a tu sistema | Responder con tus datos reales: inventario, estado de cuenta |
Si lo que quieres es manejar Conversa conversando con un asistente, sin programar nada, lee Conecta Claude a tu cuenta de Conversa.
API keys: la llave de tu sistema
Una API key es la llave con la que tu sistema entra a Conversa sin que una persona inicie sesión.
- Dónde se crea: en Configuración → API keys (está en el grupo Avanzado de Configuración).
- Quién puede: solo el dueño o un administrador de la cuenta.
- Plan: viene con el plan Pro. En Starter y Growth puedes crear solo la key para recibir leads; para usar Conversa desde Claude no necesitas key (ver «Conecta Claude a tu cuenta de Conversa»). El plan se cambia en Configuración → Plan y facturación. Si cambias de plan, las keys que ya creaste no se borran: siguen funcionando con lo que incluye el plan nuevo.
- Se ve una sola vez. Al tocar Crear key, Conversa te muestra la key completa con el aviso Copia esta key ahora — se muestra una sola vez y no se puede recuperar. Cópiala y entrégala por un medio seguro a quien la va a instalar. Si se pierde, crea otra y revoca la anterior.
- Cada key pertenece a una sola empresa: la que tengas activa al crearla.
Permisos: dale a cada sistema solo lo que use
Al crear la key eliges qué puede hacer. Lo más seguro es marcar solo lo que ese sistema necesita: si tu sistema de facturación solo manda avisos, no necesita ver tus ingresos.
| Permiso | Qué deja hacer |
|---|---|
| Enviar notificaciones | Mandar avisos con tus plantillas aprobadas |
| Leer plantillas | Ver tus plantillas y qué datos pide cada una |
| Crear plantillas | Crear plantillas nuevas y mandarlas a revisión de Meta, o borrarlas |
| Leer campañas | Ver cómo le fue a cada campaña y a cada destinatario |
| Leer métricas del canal (ingresos y costos) | Ver conversaciones, ventas, ingresos y costos de todo el canal |
| Ver el menú | Ver tus productos, precios y disponibilidad |
| Cambiar el menú (agotado, precio, productos nuevos) | Marcar productos agotados, cambiar precios y crear productos |
| Ver pedidos (con nombre y dirección del cliente) | Ver tus pedidos con los datos del cliente |
| Ver la base de conocimiento | Leer lo que sabe tu bot |
| Cambiar lo que responde el bot | Agregar o corregir respuestas del bot |
Cuatro permisos llevan la marca sensible y vienen sin marcar: Leer métricas del canal, Cambiar el menú, Ver pedidos y Cambiar lo que responde el bot. Puedes darlos, pero piénsalo dos veces: exponen ingresos, datos de tus clientes o lo que ven tus clientes.
Revocar una key
En la lista de API keys toca Revocar junto a la key. Deja de funcionar y queda marcada como Revocada. Revócala si la persona o el proveedor que la tenía ya no trabaja contigo, o si crees que alguien más la vio. En la lista también ves el Último uso de cada key, que te ayuda a saber cuáles siguen en uso.
Qué puede hacer tu sistema con la API
- Mandar avisos por WhatsApp con tus plantillas aprobadas: confirmación de pedido, recordatorio de pago, aviso de entrega. Tu sistema solo llena los datos de la plantilla; no puede escribir mensajes libres, porque WhatsApp solo permite plantillas fuera de la ventana de 24 horas.
- Programar avisos para que salgan más tarde, en vez de enviarlos en el momento.
- Enviar una campaña que ya creaste en Conversa.
- Elegir el número desde el que sale el aviso, si tienes varios. Si no se indica, sale desde tu número principal.
- Consultar tus plantillas y su estado de aprobación.
- Consultar los resultados de tus campañas y de cada destinatario: a quién se le envió, a quién le llegó y quién respondió.
Las respuestas de tus clientes llegan a tu bandeja de Conversa, como cualquier conversación. Los avisos respetan a quienes pidieron no recibir mensajes.
Webhooks salientes: Conversa le avisa a tu sistema
Un webhook es el camino inverso: cuando pasa algo en Conversa, le mandamos un aviso a tu sistema para que reaccione. Por ejemplo, registrar la venta en tu ERP o crear el prospecto en tu lista de clientes.
Se configuran en Configuración → Conectores, en la sección Webhooks salientes:
- URL: la dirección de tu sistema que recibe los avisos. Te la da tu programador.
- Secreto de firma: una clave larga que acuerdas con tu programador. Con ella, tu sistema comprueba que el aviso viene de verdad de Conversa y no de alguien que conoce la URL. Una vez guardado no se vuelve a mostrar.
- Eventos: marca los que le interesan a tu sistema:
- Marca Activo y toca Guardar webhooks.
Un mismo aviso puede llegar dos veces. Si tu sistema no responde o da un error de su lado, lo reintentamos varias veces, así que la entrega es "al menos una vez". Tu programador debe ignorar los repetidos usando el identificador x-cima-event-id, que es el mismo en cada reintento.
Conectores: el bot le pregunta a tu sistema
Con un conector, el bot consulta tu sistema en medio de la conversación y responde con tus datos reales: si hay existencia de un producto, el saldo de una cuenta, el estado de un pedido.
- En Configuración → Conectores, crea un Conector propio: le pones un nombre, una etiqueta que lo describa (por ejemplo, "Estado del pedido"), la dirección de tu sistema y los datos que necesita (por ejemplo, el número de pedido o el teléfono).
- Si tu sistema pide una clave para entrar, guárdala ahí. Se guarda cifrada y no se vuelve a mostrar.
- En Flujo, agrega un paso Integración y elige el conector. El bot le manda a tu sistema los datos que pide el conector y usa la respuesta para seguir la conversación.
Los conectores de ejemplo usan datos de demostración hasta que los apuntas a tu sistema.
Para tu equipo técnico
Si tu equipo técnico necesita la documentación de la API, los webhooks y los conectores, escríbenos a soporte y se la compartimos.