Retell AI Webhook Integration System

Este sistema maneja los webhooks de Retell AI y los distribuye tanto al panel de Chat-Dash como a un sistema de logging local para desarrollo e integración.

Creado por: Carlos Presa
Fecha: 7 de Julio de 2025

Arquitectura del Sistema

Retell AI → forward.php → ├── Chat-Dash API
                         └── integration.php → webhook.log

Archivos del Sistema

1. forward.php (Punto de Entrada Principal)

• Función: Recibe los webhooks originales de Retell AI
• Características:
  • Recibe todas las variables exactamente como las envía Retell AI
  • Reenvía los datos a dos destinos simultáneamente:
    1. Panel de Chat-Dash (solo eventos call_analyzed)
    2. Archivo integration.php (todos los eventos)
  • Responde inmediatamente a Retell AI con status 200

2. integration.php (Sistema de Logging y Desarrollo)

• Función: Procesa y registra todos los webhooks para desarrollo
• Características:
  • Recibe los datos reenviados desde forward.php
  • Registra todos los detalles del webhook en webhook.log
  • Sobreescribe el archivo de log en cada nueva llamada
  • Maneja errores y los registra en error.log con formato Apache
  • Útil para implementar y debuggear integraciones
• ⚠️ Importante: Este archivo debe ser editado y personalizado según las necesidades específicas de cada proyecto

3. webhook.log (Registro de Webhooks)

• Función: Contiene el último webhook recibido
• Formato: Incluye headers, parámetros, body raw y JSON parseado
• Actualización: Se sobreescribe con cada nuevo webhook

4. error.log (Registro de Errores)

• Función: Registra errores del sistema en formato Apache
• Uso: Para debugging y monitoreo de errores

Flujo de Datos

1. Retell AI envía webhook → forward.php
2. forward.php procesa y envía a:
   • Chat-Dash API: Solo eventos call_analyzed
   • integration.php: Todos los eventos con datos originales
3. integration.php registra todo en logs para desarrollo

Configuración

URLs de Destino

• Chat-Dash API: https://api.chat-dash.com/v1/private/chatbots/686b936cc6bd9e57d4fa352d/import/webhook
• Integration Local: http://localhost/path/to/integration.php

Webhook de Retell AI

Configurar en Retell AI para apuntar a: https://tu-dominio.com/path/to/forward.php

Desarrollo e Integración

Para implementar nuevas funcionalidades:

1. Revisar webhook.log para entender la estructura de datos de Retell AI
2. Modificar integration.php para agregar tu lógica de negocio específica del proyecto
3. Usar error.log para debugging en caso de errores
4. El archivo forward.php generalmente no necesita modificaciones

Nota importante: El archivo integration.php incluido es una plantilla base. Debe ser modificado y adaptado según los requerimientos específicos de tu proyecto e integración.

Eventos Procesados

• Todos los eventos: Se registran en integration.php
• Solo call_analyzed: Se envían al panel de Chat-Dash
• Respuesta inmediata: Retell AI recibe confirmación sin esperar procesamientos

Logs de Ejemplo

webhook.log

=== RETELL AI WEBHOOK ===
Received at: 2024-01-15 14:30:22
Method: POST
From IP: 192.168.1.100
...
=== RAW BODY ===
{"event": "call_analyzed", "data": {...}}

error.log (formato Apache)

[Mon Jan 15 14:30:22.123456 2024] [php:error] [pid 12345] [client 192.168.1.100] Error message...

Mantenimiento

• Los logs se mantienen automáticamente
• webhook.log se sobreescribe en cada llamada (solo el último evento)
• error.log se acumula (recomendado rotar periódicamente)
• No requiere base de datos ni configuración adicional