Defina seu webhook

Um webhook é um callback HTTPS criado por um parceiro que especifica como o agente precisa responder a mensagens e eventos. A menos que você esteja usando uma solução automatizada pré-criada, como o Dialogflow, você precisa definir um webhook personalizado para definir o comportamento do seu agente.

webhooks no nível do agente e do parceiro

O webhook pode ser definido no nível do parceiro ou do agente. Os webhooks no nível do parceiro se aplicam a cada agente que você mantém, enquanto os webhooks no nível do agente se aplicam a um agente individual.

Se você opera vários agentes com comportamento distinto, convém definir um webhook diferente para cada agente usando a configuração no nível do agente. Por outro lado, se os agentes tiverem um comportamento semelhante ou se você tiver apenas um agente, use o webhook no nível do parceiro.

Se você tiver um webhook no nível do parceiro e no nível do agente configurados, o webhook no nível do agente terá precedência sobre o agente específico, enquanto o webhook no nível do parceiro se aplicará aos agentes que não têm um webhook no nível do agente.

Definir o webhook no nível do parceiro

Para definir o webhook no nível do parceiro, siga estas etapas:

  1. Abra o Console do desenvolvedor do Business Communications e faça login com sua Conta do Google do Business Messages.
  2. Abra as Configurações da conta.
  3. Verifique se a conta de parceiro correta está selecionada.
  4. Em URL do webhook do Business Messages, clique em Configurar.
  5. Em Webhook endpoint URL, insira o URL do seu aplicativo + "/callback/". Por exemplo, ele pode ser algo como "https://PROJECT_ID.appspot.com/callback/".
  6. Anote o valor de clientToken. Você precisa dele para verificar se as mensagens recebidas são provenientes do Google.

  7. Configure o webhook para aceitar uma solicitação POST com o parâmetro clientToken especificado e enviar uma resposta 200 OK com o valor de texto simples do parâmetro secret como o corpo da resposta. Por exemplo, suponha que seu webhook receba uma solicitação POST com o seguinte conteúdo do corpo:

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

    Nesse caso, o webhook precisa confirmar o valor clientToken e, se clientToken estiver correto, retornar uma resposta 200 OK com 0123456789 como o corpo.

  8. No console, clique em Verificar. Quando o Business Messages verifica seu webhook, a caixa de diálogo é fechada.

Definir um webhook no nível do agente

Você recebe as mensagens enviadas ao agente no webhook no nível do parceiro. Se você quiser que um agente específico chegue às mensagens em um webhook diferente, defina um webhook no nível do agente.

  1. Abra o Console do desenvolvedor do Business Communications e faça login com sua Conta do Google do Business Messages.
  2. Clique no seu agente.
  3. Clique em Integrations.
  4. Em Webhook, clique em Configurar.
  5. Em URL do endpoint do webhook, insira o URL do webhook, começando com "https://".
  6. Anote o valor de clientToken. Você precisa dele para verificar se as mensagens recebidas são provenientes do Google.

  7. Configure o webhook para aceitar uma solicitação POST com o parâmetro clientToken especificado e enviar uma resposta 200 OK com o valor do parâmetro secret. Por exemplo, suponha que seu webhook receba uma solicitação POST com o seguinte conteúdo do corpo:

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

    Nesse caso, o webhook precisa confirmar o valor de clientToken e, se clientToken estiver correto, retornar uma resposta 200 OK com o parâmetro de URL secret definido como 0123456789.

  8. No console, clique em Verificar. Quando o Business Messages verifica seu webhook, a caixa de diálogo é fechada.