# 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.

URL: https://agentclic.com/docs/flujos/paso-peticion-webhook
Última revisión: 2026-11-02

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.

> **Consejo:** Si la API la vas a usar mucho y en varios agentes, conéctala en la pestaña **Herramientas** y usa el paso [Herramienta](https://agentclic.com/docs/flujos/pasos-de-un-flujo#herramienta). La Petición Webhook es más rápida de configurar para llamadas puntuales.

## Paso a paso

1. Añade el paso **Petición Webhook**.
2. 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://`.
3. Añade los **Parámetros de consulta** y las **Cabeceras** que pida el servicio. Por defecto ya lleva `Content-Type: application/json`.
4. Escribe el **Cuerpo** en JSON (no se usa con GET). Puedes insertar [variables](https://agentclic.com/docs/flujos/variables) con el selector.
5. 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](https://agentclic.com/docs/flujos/pasos-de-un-flujo#condicion) 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](https://agentclic.com/docs/flujos/probar-y-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.