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é, és megtalálja a Webhook Node-ot. Add hozzá és nyissa meg.
2. lépés: Állítsa be az endpointot
Az első dolog, amit látni fog, az az endpoint URL-je. Illessze be a háttérrendszer webhook URL-jét. Még mindig tesztel? Használja a [webhook.site] ingyenes URL-jét (https://webhook.site), másolja oda egyedi URL-jét, és illessze be az IntraCordba.
Állítsa a módszert POST-ra. Ha a háttérrendszernek hitelesítésre van szüksége, adjon hozzá egy bearer tokent vagy API-kulcsot itt is.
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 hurok: a háttérrendszer elküldi a initial_context-t az IntraCord-ba, az IntraCord futtatja a hívást és kicsomagolja a gathered_context-t, a webhook Node pedig visszaküldi a végső strukturált adatokat a háttérrendszernek. Éles gyártáshoz cserélje le a webhook.site URL-t a valódi háttér-URL-re.
Következő lépések
- Valódi telefonszám csatlakoztatása: A Connect with Telephony a Twilio csatlakoztatását takarja, így ezek a hívások valódiak.
- A teljes változólista és hitelesítési lehetőségek: lásd a Webhook hivatkozás és a Webhook Payloads fejlesztői hivatkozás.