Paso Petición Webhook
Envía datos desde un flujo de Agentclic a cualquier servicio externo con el paso Petición Webhook: método, URL, cabeceras, cuerpo y respuesta.
El paso Petición Webhook envía una petición HTTP desde un flujo a cualquier servicio externo: tu propio sistema, una hoja de cálculo, n8n, Make u otra API. Puedes elegir el método, añadir cabeceras y parámetros, enviar un cuerpo en JSON y usar la respuesta en los pasos siguientes.
Para qué sirve
- Enviar los datos de un contacto nuevo a otra herramienta.
- Lanzar una automatización externa cuando el agente termina una tarea.
- Consultar un dato en otro sistema y usarlo en el flujo.
Paso a paso
- Añade el paso Petición Webhook.
- En Método y URL, elige el método (GET, POST, PUT, PATCH o DELETE) y escribe la dirección, que debe empezar por
https://. - Añade los Parámetros de consulta y las Cabeceras que pida el servicio. Por defecto ya lleva
Content-Type: application/json. - Escribe el Cuerpo en JSON (no se usa con GET). Puedes insertar variables con el selector.
- Revisa el Alias de salida (por defecto
webhook_response) y el Timeout (por defecto 15000 ms; mínimo 1000).
Para autenticarte, añade una cabecera como Authorization: Bearer {tu-token}.
La respuesta
En los pasos siguientes puedes usar:
| Variable | Qué contiene |
|---|---|
{{webhook_response.status}} | El código de estado HTTP, por ejemplo 200. |
{{webhook_response.ok}} | Si la petición ha ido bien. |
{{webhook_response.body}} | El cuerpo de la respuesta. Usa .body.campo para leer un dato. |
Combínalo con una Condición sobre {{webhook_response.ok}} para hacer una cosa u otra según el resultado.
Qué direcciones se admiten
Por seguridad, la URL:
- debe empezar por
https://; - no puede tener el dominio dentro de una variable (sí la ruta o los parámetros);
- no puede incluir usuario ni contraseña;
- debe ser una dirección pública de internet.
Si no se cumple, el editor no guarda el cambio y te dice el motivo.
Problemas frecuentes
Al probar el flujo, la petición no llega a mi servicio
«Probar flujo» no envía la Petición Webhook: solo la prepara y la muestra en la consola. Se envía de verdad cuando el flujo se ejecuta en una conversación, por un webhook o por una programación. Ver Probar un flujo y revisar sus ejecuciones.
«La URL debe empezar por https://»
Cambia la dirección a https://. Las direcciones http:// no se admiten.
La petición tarda y falla
Si el servicio tarda más que el Timeout, la petición se corta. Sube el valor si el servicio es lento.