Configura tu webhook

Un webhook es una devolución de llamada HTTPS creada por un socio que especifica cómo tu agente deben responder a mensajes y eventos. A menos que uses un sistema automatizado como Dialogflow, debes configurar un webhook personalizado para definir el comportamiento de tu agente.

Webhooks de nivel de socio y de agente

Puedes configurar tu webhook a nivel de socio o de agente. Los webhooks de nivel de socio se aplican a cada agente que mantienes, mientras que a nivel de agente y cada webhook se aplica a un agente individual.

Si operas varios agentes con comportamientos distintos, puedes establecer una un webhook diferente para cada agente con la configuración a nivel de agente. Del otro si tus agentes tienen un comportamiento similar o si solo tienes un agente, puedes usar el webhook a nivel de socio.

Si tienes configurados tanto un webhook de nivel de socio como uno de agente el webhook de nivel de agente tiene prioridad en su agente específico, mientras que El webhook a nivel de socio se aplica a los agentes que no tienen un webhook.

Configura tu webhook a nivel de socio

Para configurar tu webhook a nivel de socio, sigue estos pasos:

  1. Abre la consola para desarrolladores de Business Communications. y accede con tu Cuenta de Google de Business Messages.
  2. Abre la Configuración de la cuenta.
  3. Asegúrate de que se haya seleccionado la cuenta de socio correcta.
  4. En URL de webhook de Business Messages, haz clic en Configurar.
  5. En URL de extremo de webhook, ingresa la URL de tu aplicación y “/devolución de llamada/”. Por ejemplo, podría ser algo como “https://PROJECT_ID.appspot.com/callback/”.
  6. Anota tu valor de clientToken. Debes hacerlo para verificar que los mensajes que recibes provengan de Google.

  7. Configura tu webhook para que acepte una solicitud POST con el valor especificado El parámetro clientToken y envía una respuesta 200 OK con el texto sin formato. del parámetro secreto como el cuerpo de la respuesta. Por ejemplo, imagina que tu webhook recibe una solicitud POST con el siguiente contenido en el cuerpo:

    {
    "clientToken":"SJENCPGJESMGUFPY",
          "secret":"0123456789"
    }

    En ese caso, tu webhook debería confirmar el valor de clientToken y, si clientToken es correcto; muestra una respuesta 200 OK con 0123456789 como cuerpo de respuesta.

  8. En la consola, haz clic en Verificar. Cuando Business Messages verifica tu webhook, se cierra el diálogo.

Configura un webhook a nivel de agente

Recibes los mensajes enviados a tu agente en tu webhook de nivel de socio. Si quieres que los mensajes para un agente específico lleguen a un webhook diferente, puede configurar un webhook a nivel de agente.

  1. Abre la consola para desarrolladores de Business Communications. y accede con tu Cuenta de Google de Business Messages.
  2. Haz clic en tu agente.
  3. Haz clic en Integrations.
  4. En Webhook, haz clic en Configurar.
  5. En URL de extremo de webhook, ingresa la URL de tu webhook. Comienza con “https://”.
  6. Anota tu valor de clientToken. Lo necesitas para verificar que los mensajes reciben provenientes de Google.

  7. Configura tu webhook para que acepte una solicitud POST con el valor especificado parámetro clientToken y envía una respuesta 200 OK con el valor del Secret. Por ejemplo, supongamos que tu webhook recibe una solicitud POST. con el siguiente contenido del cuerpo:

    {
          "clientToken":"SJENCPGJESMGUFPY",
          "secret":"0123456789"
    }

    En ese caso, tu webhook debería confirmar el valor de clientToken y, si clientToken es correcto; muestra una respuesta 200 OK con la URL secreta configurado en 0123456789.

  8. En la consola, haz clic en Verificar. Cuando Business Messages verifica tu webhook, se cierra el diálogo.