Ugrás a fő tartalomhoz

Adatok szinkronizálása a Webhook segítségével

Az utolsó oldal az API Trigger és a initial_context segítségével történő hívásba való adatok küldését tárgyalta. Most a másik oldal: hogyan küldi el az IntraCord a tanultakat a rendszerébe, miután a hívás véget ért.

A kinyert adatok gathered_context-ben élnek. Tehát a teljes kép a következő: initial_context az, amit a backend küld a hívásba, a gathered_context pedig az, amit IntraCord kivon belőle. A Webhook Node segítségével állíthatja vissza a gathered_context-t.

1. lépés: Adja hozzá a Node-ot​

Kattintson a Node hozzáadása lehetőségre, görgessen lefelé, majd adja hozzá és nyissa meg a Webhook Node-ot.

2. lépés: Állítsa be az endpointot​

Elsőként az endpoint URL mező jelenik meg. Illessze be backendje webhook URL-jét. Teszteléshez használhat ingyenes URL-t a webhook.site oldalon; másolja ki az egyedi URL-t, majd illessze be az IntraCordba.

Állítsa a HTTP methodot POST értékre. Ha a backend authot igényel, adjon hozzá bearer tokent vagy API-kulcsot.

3. lépés: Készítse el a payload sablonját​

Ez a fontos rész, ez határozza meg, hogy pontosan mit küld a JSON IntraCord. Mindkét típusú kontextust tartalmazza: initial_context mezők, például az adós neve, az ügyfél neve és a tartozás összege, valamint a gathered_context mezők, például a fizetendő összeg, fizetési mód és hangulat. A hívás végeredményét is megadhatja a {{gathered_context.call_disposition}} mezőben – hogyan végződött a hívás, pl. user_hangup vagy voicemail_detected.

{
  "debtor_name": "{{initial_context.debtor_name}}",
  "client_name": "{{initial_context.client_name}}",
  "debt_amount": "{{initial_context.debt_amount}}",
  "amount_user_will_pay": "{{gathered_context.amount_user_will_pay}}",
  "payment_method": "{{gathered_context.payment_method}}",
  "sentiment": "{{gathered_context.sentiment}}",
  "call_disposition": "{{gathered_context.call_disposition}}"
}

Minden itt hivatkozott változóra vonatkozóan tekintse meg a Webhook Payloads fejlesztői hivatkozást.

4. lépés: Mentés és közzététel​

Mentse a webhook Node-ot, majd tegye közzé az ügynököt.

5. lépés: Tesztelje​

Futtasson teszthívást. Amikor véget ér, térjen vissza a webhook-vevőhöz. Egy kérést fog látni mind a initial_context-vel, a hívásba küldött adatokkal, mind a gathered_context-vel, amelyet IntraCord kinyert a beszélgetésből, ugyanabban a JSON-adatban.

Ez a teljes data flow: a backend elküldi az initial_context objektumot az IntraCordnak, az IntraCord lefuttatja a hívást és előállítja a gathered_context objektumot, a Webhook Node pedig visszaküldi a végső structured data-t a backendnek. Production használathoz cserélje a webhook.site URL-t a valódi backend URL-re.

Következő lépések​