Automatizaciones mediante webhooks
Revisar solicitudes de leads
El gráfico agrupa las solicitudes en intervalos diarios, u horarios en la vista de un día. Pasa el cursor o enfoca con el teclado un punto de la línea para revelar su marcador y selecciónalo para ver las solicitudes del grupo. Cada solicitud conserva su hora exacta de recepción.
En Marketing → Automatización de contactos → Resumen, el gráfico Solicitudes de leads a lo largo del tiempo permite comparar los formularios y webhooks que aportan leads. Cada línea muestra el total acumulado del período: el último día o los últimos 7, 30 o 90 días. Selecciona un desencadenante debajo del gráfico para ocultar o mostrar su línea.
Selecciona un punto para ver el nombre y la fecha y hora de recepción en tu zona horaria. Los nombres requieren acceso a Contactos y pueden no estar disponibles si el lead no tiene nombre. Los puntos superpuestos muestran todas las solicitudes recibidas en ese instante. Se incluyen los leads de prueba; recibir un lead no significa que su tarea se haya completado correctamente. La hora de recepción puede diferir de la de envío del formulario.
El gráfico se actualiza automáticamente; Actualizar solicitudes lo actualiza de inmediato. Si hay más de 5.000 solicitudes, se muestran las primeras 5.000 y las líneas terminan en la última incluida. Elige un período más corto para revisar solicitudes posteriores.
En las tareas de llamadas y WhatsApp, abre Configuración avanzada y elige el país para interpretar los números locales. En los webhooks debes elegirlo manualmente; los números internacionales conservan su prefijo.
Un webhook inicia el follow-up de leads procedentes de su sitio web o aplicación. Por ejemplo, una solicitud de presupuesto puede iniciar un mensaje de WhatsApp con un email alternativo y crear una oportunidad en CRM. No necesita conectar Meta Ads.
Navegación de marketing
Abra Marketing → Campañas para campañas telefónicas y de WhatsApp. En Marketing → Automatización de contactos → Resumen puede consultar resultados de Instant Forms y Webhooks y configurar CRM. Edite los flujos en Editor de automatización. Las conexiones permanecen en General → Integraciones → Plataformas publicitarias. Conectar Meta Ads abre allí la configuración. En Marketing → Plantillas de WhatsApp, seleccione un canal de WhatsApp. Se solicita confirmación antes de salir con cambios sin guardar.
Antes de empezar
Necesita acceso a Integraciones y una clave API que pueda seleccionar. Gestione sus claves en la página de claves API , o cree una al configurar el webhook. Para ejecutar tareas de follow-up, prepare el agente y su canal de WhatsApp, buzón de email o número para llamadas salientes. Conecte su CRM si quiere crear oportunidades.
Añada el webhook y su automatización
- Abra Marketing → Automatización de contactos → Editor de automatización.
- Seleccione Webhook en la paleta de nodos o arrástrelo al lienzo.
- Escriba un nombre y seleccione la Clave API. Crear nueva clave API… crea y selecciona una clave en el mismo diálogo. También puede gestionar sus claves en la página de claves API .
- Añada los datos de contacto y campos propios, como
your_field_1, a Datos del lead de prueba. Estarán disponibles para las asignaciones de tareas y CRM. - En Configurar CRM, elija el embudo y la etapa si desea crear oportunidades. Los valores compartidos de Instant Form no se aplican a webhooks.
- Pulse Aplicar, conecte el webhook a una tarea de WhatsApp, email o llamada y configúrela. Conecta las siguientes tareas mediante Si tiene éxito o Si falla. Un webhook puede iniciar varias rutas independientes.
- Pulse Guardar en el editor antes de enviar solicitudes.
Un webhook puede compartir una tarea y su alternativa con un Instant Form. Los cambios en la tarea compartida afectan a ambos activadores; las asignaciones de campos son independientes. Sin tareas ni acciones CRM, solo se guarda el contacto. Mantenga ambos filtros de Meta en Todas para ver los webhooks.
Las tareas de correo y de WhatsApp de una automatización mediante webhook pueden hacer seguimiento a los leads que no responden, igual que con los Instant Forms. Consulte Elija los follow-ups de una tarea.
Llame al webhook
Puede asignar campos de tareas o del CRM a full_name aunque envíe solo first_name y last_name: Versafy los combina automáticamente. Si envía un valor no vacío en full_name, se utilizará ese valor.
El nombre de la oportunidad puede incluir valores de los campos del lead y las variables habituales de contacto y campaña. Selecciona una variable debajo del campo de nombre para insertarla en la posición del cursor. Los formularios instantáneos ofrecen sus campos de respuesta; los webhooks, los campos de los datos de prueba. Los valores ausentes quedan vacíos y las respuestas múltiples se separan con comas. Las oportunidades existentes conservan sus nombres.
Abra Marketing → Automatización de contactos → Editor de automatización y después la configuración del nodo Webhook guardado. Copie URL del endpoint; la Solicitud de ejemplo incluye su trigger_id. Si la configuración ya está abierta, puede copiar directamente la solicitud completa. Gestione la clave seleccionada en la página de claves API . Envíe la solicitud desde el servidor de su aplicación; no publique la clave API en el código del sitio web. Use la clave seleccionada en la cabecera Authorization: Bearer. Sustituya los marcadores del ejemplo por su URL, clave e ID del activador:
curl -X POST 'YOUR_WEBHOOK_URL' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
--data '{
"trigger_id": "YOUR_TRIGGER_ID",
"event_id": "quote-request-123",
"first_name": "Alex",
"last_name": "Smith",
"company_name": "Example Company",
"email": "alex@example.com",
"phone_number": "+351916000000",
"your_field_1": "Example value 1",
"your_field_2": "Example value 2"
}'Son obligatorios trigger_id, event_id, first_name y al menos uno de email o phone_number. El apellido y la empresa son opcionales. Añada campos propios al mismo nivel del JSON, sin objetos anidados. Consulte los límites y las respuestas en la referencia de la API de webhooks . El enlace Documentación API de la configuración abre la misma referencia.
Use un event_id nuevo para cada envío nuevo. Al reintentar el mismo envío, conserve el ID y los datos: recibirá el recibo original. Modificar los datos manteniendo el mismo ID devuelve 409 Conflict.
Pruebe y consulte los resultados
Los contactos de prueba requieren direcciones de email y números de teléfono válidos, incluidos los campos personalizados de destinatario de las tareas principales y alternativas. Corrija los campos marcados antes de enviar; se rechaza el texto de relleno. Los números sin prefijo internacional usan el país configurado en la tarea. La validación comprueba el formato, no la posibilidad de recibir mensajes.
Para probar un correo sin ejecutar la automatización, abra la tarea Enviar correo, seleccione un remitente conectado, introduzca el asunto y las instrucciones y seleccione Enviar correo de prueba. Rellene los campos con valores de ejemplo y envíe la prueba al correo de su cuenta. La prueba utiliza los ajustes de la tarea y del estilo sin guardar; no guarda la tarea, no crea contactos ni activa otras acciones.
Para revisar las conversaciones de un webhook, abra Marketing → Automatización de contactos → Resumen y seleccione un total de tareas de WhatsApp, correo o llamadas superior a cero. Chats se abre filtrado por ese webhook y tipo de tarea. Quite la etiqueta del filtro o use Borrar todo para ampliar la lista. Este filtro solo está disponible mediante estos enlaces, no en el selector de filtros de Chats. Las tareas pendientes o que fallan antes de contactar pueden no tener conversación; varias tareas pueden compartir una conversación.
En la tarjeta de estadísticas del webhook, seleccione Configurar CRM para editar la creación de oportunidades. Seleccione Guardar para aplicar la configuración del CRM sin abrir el editor de automatizaciones.
En Marketing → Automatización de contactos → Resumen, cada webhook guardado muestra el número de leads y de tareas de WhatsApp, correo y llamadas creadas. Se incluyen los envíos de prueba. Las tareas creadas pueden seguir pendientes o fallar después; estas cifras no confirman la entrega. Un webhook nuevo muestra ceros hasta que recibe leads.
Las pruebas ejecutan acciones reales: pueden enviar mensajes, realizar llamadas y crear registros CRM. Use datos de contacto que controle.
Reabra el editor guardado, seleccione Cliente potencial de prueba en el webhook, edite los datos y pulse Enviar cliente de prueba. Mantenga el diálogo abierto para ver el recibo y el estado de procesamiento.
Tras un envío correcto, el diálogo prepara un nuevo ID de evento. Mantenga o edite los datos y seleccione Enviar otro contacto de prueba para repetir la prueba. Último envío identifica el recibo anterior. Si un error de conexión interrumpe la solicitud, reintente sin cambiar los datos para evitar duplicados.
202 Acceptedconfirma la aceptación para procesamiento en segundo plano, no la entrega. Conservereceipt_idpara consultar con soporte.- En General → Contactos, busque por email o teléfono. Un contacto coincidente puede actualizarse en lugar de crear otro.
- En General → Tareas, consulte el estado y los resultados. Las tareas del webhook muestran API como origen. Tenga en cuenta los retrasos y el horario laboral.
- En su CRM, revise el embudo y la etapa seleccionados, los datos del lead y las notas de follow-up de la oportunidad.
Una tarea puede fallar si no dispone de un canal de contacto utilizable. La alternativa solo se ejecuta si está conectada y dispone de los datos necesarios.
Solución de problemas
Si el agente de correo está en modo Dry Run o revisión de borradores, la automatización no envía el correo y ejecuta la acción alternativa configurada. Sin una acción alternativa, esa rama falla. Cambie el agente al modo de envío para permitir correos automáticos.
Si se rechaza la solicitud, revise la configuración guardada, URL, ID del activador, clave seleccionada y campos obligatorios. Si se acepta pero no hay mensaje, revise las conexiones y el estado de las tareas. suppressed indica que el follow-up se omitió por protección contra duplicados; revise las tareas existentes antes de reintentar. Si falta la oportunidad, compruebe la configuración CRM de este webhook.
Guías relacionadas
Actualizar oportunidades del CRM
Expanda Aplicar estos ajustes del CRM a otros webhooks para buscar otros webhooks y marcar los que desee. La sección empieza contraída; al cerrarla se conserva la selección para guardarla después.
Al guardar se recuerda el grupo seleccionado. Al volver a abrir cualquier webhook del grupo, los demás aparecen marcados automáticamente. Desmarque un webhook antes de guardar para separarlo del grupo. Para ajustes copiados antes de este cambio, guarde una vez con los webhooks deseados marcados.
Los contactos nuevos de solicitudes por webhook tienen la fuente Webhook. Las automatizaciones de WhatsApp guardan el contacto antes del envío; la sincronización del CRM reutiliza el contacto vinculado. Aplicar estos ajustes del CRM a otros webhooks copia los ajustes del CRM y rechaza selecciones incompatibles sin guardar cambios. Se aplican las reglas del CRM para formularios.