Imposta il webhook

Un webhook è un callback HTTPS creato da un partner che specifica in che modo deve rispondere a messaggi ed eventi. A meno che tu non stia usando un modello di machine learning predefinito come Dialogflow, devi impostare un webhook personalizzato per definire il comportamento per l'agente.

Webhook a livello di partner e di agente

Puoi impostare il webhook a livello di partner o di agente. I webhook a livello di partner si applicano a ogni agente che gestisci, mentre a livello di agente i webhook si applicano ciascuno a un singolo agente.

Se gestisci più agenti con un comportamento diverso, ti consigliamo di impostare un un webhook diverso per ogni agente, utilizzando l'impostazione a livello di agente. Dall'altra parte Se i tuoi agenti hanno un comportamento simile o se hai un solo agente, puoi usare il webhook a livello di partner.

Se hai configurato sia un webhook a livello di partner che un webhook a livello di agente, il webhook a livello di agente ha la precedenza sul suo agente specifico, mentre Il webhook a livello di partner si applica agli agenti che non hanno un webhook a livello di agente. tramite webhook.

Imposta il webhook a livello di partner

Per impostare il webhook a livello di partner, segui questi passaggi:

  1. Apri la Console per gli sviluppatori di Business Communications e accedi con il tuo Account Google Business Messages.
  2. Apri le Impostazioni account.
  3. Assicurati che sia selezionato l'account partner corretto.
  4. Per URL webhook di Business Messages, fai clic su Configura.
  5. In URL endpoint webhook, inserisci l'URL dell'applicazione + "/callback/". Ad esempio, potrebbe trattarsi di "https://PROJECT_ID.appspot.com/callback/".
  6. Prendi nota del tuo valore di clientToken. È necessario per verificare che i messaggi che ricevi provengono da Google.

  7. Configura il webhook per accettare una richiesta POST con il clientToken e invia una risposta 200 OK con testo normale del parametro secret come corpo della risposta. Ad esempio, supponiamo che webhook riceve una richiesta POST con i seguenti contenuti del corpo:

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

    In questo caso, il webhook deve confermare il valore clientToken. Se clientToken è corretto, restituisce una risposta 200 OK con 0123456789 come corpo della risposta.

  8. Nella console, fai clic su Verifica. Quando Business Messages verifica il webhook, la finestra di dialogo si chiude.

Imposta un webhook a livello di agente

Ricevi i messaggi inviati all'agente al webhook a livello di partner. Se Se vuoi che i messaggi di un agente specifico arrivino a un webhook diverso, puoi impostare un webhook a livello di agente.

  1. Apri la Console per gli sviluppatori di Business Communications e accedi con il tuo Account Google Business Messages.
  2. Fai clic sull'agente.
  3. Fai clic su Integrations (Integrazioni).
  4. Per Webhook, fai clic su Configura.
  5. In URL endpoint webhook, inserisci l'URL del webhook, che inizia con "https://".
  6. Prendi nota del tuo valore di clientToken. È necessario per verificare che i messaggi provengono da Google.

  7. Configura il webhook per accettare una richiesta POST con il parametro clientToken e invia una risposta 200 OK con il valore parametro secret. Ad esempio, supponiamo che il webhook riceva una richiesta POST con i seguenti contenuti:

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

    In questo caso, il webhook deve confermare il valore clientToken. Se clientToken è corretto, restituisce una risposta 200 OK con l'URL del secret impostato su 0123456789.

  8. Nella console, fai clic su Verifica. Quando Business Messages verifica il webhook, la finestra di dialogo si chiude.