Integraciones salientes desde Ropofy

Webhooks (Ganchos Web)

Para permitir que Ropofy envíe información y ejecute acciones en sistemas externos (CRM, ERP, plataformas de marketing, sistemas internos, etc.), la plataforma ofrece integraciones mediante Webhooks, también conocidos como Ganchos Web.

Un webhook es un mecanismo que permite a Ropofy enviar información automáticamente a una URL externa cuando ocurre un evento específico dentro de la plataforma, eliminando la necesidad de realizar consultas constantes (polling) y permitiendo integraciones en tiempo real.

¿Para qué se pueden usar los Webhooks?

Los Webhooks de Ropofy permiten, entre otros casos:

• Enviar datos de contactos a sistemas externos

• Sincronizar información con CRM o ERP

• Registrar eventos como respuestas de clientes

• Disparar procesos automáticos en plataformas externas

• Integrar flujos de encuestas, ventas o soporte

• Ejecutar acciones personalizadas en sistemas internos

Tipos de Webhooks disponibles en Ropofy

Ropofy cuenta con dos tipos de Webhooks, diseñados para distintos niveles de personalización y complejidad:

1. Webhook estándar

El Webhook estándar permite enviar automáticamente los datos del contacto y la información básica del evento hacia una URL externa.

Características principales

• Envío automático de datos estándar del contacto

• Configuración sencilla desde el constructor de flujos

• No requiere definir manualmente el cuerpo de la solicitud

• Ideal para integraciones rápidas y casos de uso comunes

Configuración disponible

• Método HTTP: POST - GET

• URL destino: Endpoint del sistema externo

• Custom Data: Permite agregar pares clave–valor adicionales

• Headers: Posibilidad de enviar encabezados personalizados

Este tipo de webhook incluye por defecto los datos estándar del contacto, junto con cualquier información adicional configurada en Custom Data.

2. Custom Webhook (Webhook personalizado)

El Custom Webhook es una opción avanzada que permite un control total sobre la estructura de la solicitud enviada al sistema externo.

⚠️ Nota: Esta es una funcionalidad premium y su uso puede generar costos adicionales por ejecución.

Características principales

• Totalmente personalizable

• Permite definir el evento como CUSTOM

• Soporta headers, query parameters y cuerpo personalizado

• Ideal para integraciones complejas o sistemas con requisitos específicos

Opciones de configuración

• Método HTTP: POST - GET - PUT - DELETE

• URL destino: Endpoint del sistema externo

• Authorization: Configurable según el sistema receptor

• Headers: Personalizados

• Query Parameters: Opcionales

• Content-Type: Generalmente application/json

• Raw Body: Definición manual del payload en formato JSON

Ejemplo de cuerpo (Raw Body)

{
  "id": "{{contact.id}}",
  "name": "{{contact.name}}",
  "email": "{{contact.email}}",
  "phone": "{{contact.phone}}"
}

Este enfoque permite enviar solo los datos necesarios, en el formato exacto que requiera el sistema receptor.

¿Cuándo usar cada tipo de Webhook?

Consideraciones finales

• Ambos Webhooks se configuran desde el constructor de flujos de Ropofy

• El sistema receptor debe estar preparado para recibir solicitudes HTTP

• Para integraciones críticas, se recomienda implementar manejo de errores y logs en el sistema externo