Imposta il webhook

Un webhook è un callback HTTPS creato dal partner che specifica il modo in cui l'agente deve rispondere a messaggi ed eventi. A meno che non utilizzi una soluzione automatica predefinita come Dialogflow, devi impostare un webhook personalizzato per definire il comportamento del tuo agente.

Webhook a livello di partner e di agente

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

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

Se hai configurato sia un webhook a livello di partner sia 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 dispongono di un webhook a livello di agente.

Imposta il webhook a livello di partner

Per impostare il webhook a livello di partner:

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

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

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

    In questo caso, il webhook deve confermare il valore clientToken e, se clientToken è corretto, restituire 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 al tuo agente sul webhook a livello di partner. Se invece vuoi che i messaggi vengano inviati a un agente specifico in un webhook diverso, puoi impostare un webhook a livello di agente.

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

  7. Configura il tuo webhook per accettare una richiesta POST con il parametro clientToken specificato e invia una risposta 200 OK con il valore del parametro segreto. Ad esempio, supponiamo che il tuo webhook riceva una richiesta POST con il seguente contenuto del corpo:

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

    In questo caso, il webhook deve confermare il valore clientToken e, se clientToken è corretto, restituire una risposta 200 OK con il parametro URL segreto impostato su 0123456789.

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