Base de conocimiento de GetMyBot

Solicitudes web y webhooks

Haz que un evento de tu sitio active el bot o que una reacción consulte otro servicio.

En esta página

Tu sitio puede avisar al bot de un nuevo pedido, y el bot puede consultar en el sitio el estado de ese pedido. Son dos formas distintas de intercambiar datos:

DirecciónQuién inicia el intercambioEjemplo
Webhook entranteOtro servicio envía un aviso a GetMyBot y activa una reacciónLlega una solicitud desde el sitio y el bot avisa a un responsable.
Solicitud web salienteUna reacción consulta otro servicio y recibe su respuestaEl bot consulta el precio o el estado de un pedido.

Un webhook es un aviso automático entre servicios. Ambas opciones utilizan HTTP, el mismo protocolo que usa el navegador para abrir sitios web. Para conexiones ya preparadas, consulta Integraciones.

Webhook entrante

El disparador Solicitud web entrante (webhook) inicia una reacción cuando llega una solicitud desde otro servicio:

  • Dirección: activa el disparador y guarda la reacción. GetMyBot generará la URL de su webhook y la mostrará en este campo. Puedes copiarla, pero no modificarla.
  • Token secreto: impide que personas ajenas activen la reacción.
  • Método: POST, GET, PUT o ANY.

Los campos recibidos se guardan en los datos temporales de la reacción (ctx). Si el servicio envía order_id, podrás leerlo como {{ctx.order_id}}. Una vez configurado el webhook, envía una solicitud de prueba y comprueba que la reacción recibió los campos esperados.

Solicitud web saliente

La acción Solicitud web permite a una reacción llamar a otro servicio. Puedes configurar:

  • El método (GET, HEAD, OPTIONS, POST, PUT, PATCH o DELETE), los encabezados y el contenido de la solicitud en formato JSON o texto.
  • Los códigos que indican éxito, el tiempo de espera y cuántas veces se repetirá la solicitud si falla.
  • Dónde guardar la respuesta, en un parámetro del usuario o en los datos temporales (ctx). JSONPath sirve para seleccionar un campo concreto de la respuesta.
  • El modo asíncrono: el bot continúa la reacción sin esperar al servicio. Puedes tratar el resultado con una reacción distinta para el éxito o el error.

Otras acciones relacionadas son Cargar URL, que descarga el texto de una página a ctx, y Consulta a una fuente / Escribir en una fuente, que usan conexiones guardadas. Consulta Fuentes y claves.

Integración mediante webhook

Si vas a enviar datos con frecuencia al mismo servicio, configura una integración de tipo Webhook. Indica su dirección y una firma HMAC para que el servicio receptor pueda verificar de dónde vienen los datos. Consulta Integraciones.

Seguridad

Protege los webhooks entrantes con un token secreto. Las solicitudes salientes no pueden acceder a direcciones privadas de la red interna a través de GetMyBot; esta protección se conoce como SSRF. El tamaño de la respuesta también está limitado.

Siguientes pasos