ChatCieloDocs

Integraciones

Centro de integraciones de ChatCielo: Meta Cloud API (WABA), n8n, Webhooks, Typebot, Telefonía SIP y VAPI.

Integraciones

ChatCielo es una plataforma API-first: cada canal, contacto, mensaje y oportunidad puede conectarse con herramientas externas vía integraciones nativas, webhooks y conectores como n8n. Usa este centro para elegir el conector correcto según tu caso.

La mayoría de integraciones se configuran por canal (Canales > Tu canal > Integración) o a nivel global (Configuraciones > Integraciones). Habilítalas solo donde aporten valor para evitar latencia innecesaria.

Catálogo de integraciones

Meta Cloud API (WABA Oficial)

Número verificado de WhatsApp, plantillas aprobadas y webhooks de estado. Máxima entregabilidad.

n8n

Orquestación low-code: sincroniza CRM, Sheets, ERP y dispara mensajes bidireccionales.

Webhooks

POST saliente y entrante para eventos de mensaje, cierre, creación de contacto y cambio de etapa.

Typebot

Flujos visuales con botones, formularios y variables; se incrusta como bot del canal.

Telefonía SIP / WavoIP

Llamadas VoIP desde la ficha del contacto y registro de llamada en el historial.

VAPI / Voz IA

Agentes de voz con TTS/STT y derivación a humano cuando la IA no resuelve.

Meta Cloud API (WABA Oficial)

  • Requiere Business Manager verificado, token y webhook de Meta configurado.
  • Gestiona plantillas (templates) para mensajes fuera de ventana de 24 h.
  • ChatCielo sincroniza estados (enviado/entregado/leído) y opt-in/opt-out.
  • Para detalles paso a paso, consulta la sección Canales > WhatsApp Oficial WABA.

No uses plantillas WABA para spam: Meta penaliza la calidad del número. Usa segmentación por etiqueta y consentimiento explícito.

n8n

  • Trigger: Webhook POST de ChatCielo (nuevo mensaje, cierre, cambio de etapa) → n8n.
  • Acción: n8n → ChatCielo (enviar mensaje, mover oportunidad, crear contacto) vía API/Webhook.
  • Casos frecuentes: enriquecer leads con Clearbit/Sheets, crear oportunidades en HubSpot/Salesforce, disparar campañas tras pago.

Webhooks

  • Saliente: ChatCielo hace POST a tu URL en eventos configurables. Firma y reintentos según tu implementación.
  • Entrante: tu sistema hace POST a la API de ChatCielo para crear mensajes, contactos u oportunidades. Documentado en API WABA.
  • Valida con un endpoint de prueba (ej. webhook.site) antes de conectar producción.

Registra versión del webhook y correo de alerta técnica. Si tu endpoint devuelve 4xx/5xx reiterados, ChatCielo podrá pausar el envío hasta corrección.

Typebot

  • Crea flujos con bloques, variables ({{name}}, {{email}}) y lógica condicional.
  • Conéctalo al canal como integración externa; define palabra clave de retorno a humano.
  • Úsalo para triaje estructurado y deja la IA generativa para respuestas abiertas.

Telefonía SIP / WavoIP

  • Requiere credenciales SIP y permisos por agente.
  • Desde Atenciones o Contactos verás el icono de teléfono; la llamada queda registrada en la línea de tiempo.
  • Combina con Sesiones para auditar uso y con Reportes para métricas de contacto efectivo.

VAPI y voz con IA

  • Conecta tu API Key de VAPI, define el prompt de voz y el número SIP.
  • ChatCielo deriva la llamada al agente humano según reglas de cola y horario.
  • Para TTS en texto, consulta también Modelos de Voz ChatGPT.

Criterio de elección rápida

NecesidadIntegración recomendada
Entregabilidad máxima y plantillas verificadasWABA Oficial
Orquestación CRM ↔ ChatCielo con lógica complejan8n
Notificar a tu backend en cada eventoWebhooks
Formularios y menús guiadosTypebot
Llamar al cliente desde la fichaSIP / WavoIP
Atención por voz con IAVAPI

Para bots conversacionales con IA generativa, completa esta lectura con Bots de IA y Modelos de IA.