Samtalsflöden: anrop, status och händelser

Resurser i den medföljande referensen

• POST /v1/Calls — skapa ett utgående samtal.
• GET /v1/Calls/{callId} — läs information om ett känt samtal.
• POST /v1/Calls/{callId} — utför stödda åtgärder på ett pågående samtal.

Avgränsa ett samtalsförsök

Tilldela er interna begäran en egen referens och koppla den till det samtals-ID ni får från leverantören. Skilj försökets status från CRM-aktivitetens status: ett avslutat samtal innebär inte att uppföljningen är granskad.

Referensen anger behörigheten call.create för de ovanstående resurserna. Läs den aktuella specifikationen även för läsanropet; gissa inte rättighetens namn utifrån HTTP-metoden.

Händelser och återförsök

Skapandeoperationens notify-fält beskriver URL:er som kan få händelser, till exempel answer och hangup. Vilken payload, avsändarverifiering och leveransgaranti som gäller måste bekräftas för anslutningen. Referensen här räcker inte för att uppfinna en signaturheader eller ett löfte om exakt en leverans.

Behandla mottagen data enligt ett verifierat schema och håll en tydlig koppling till kund och samtal. Planera hur ni upptäcker missade händelser och hur status kan stämmas av.

En kontraktsdetalj att kontrollera

I den medföljande specifikationen beskriver skapandeoperationens schema caller som ett objekt med number och name, medan några exempel använder en sträng. Bekräfta accepterat format före ett riktigt POST-anrop. Därför visar vi inget skenbart körklart skapandeexempel som döljer skillnaden.

Testa er interna behandling separat

Referensexemplet för CRM använder ert eget normaliserade testformat. Det går att köra lokalt utan åtkomst till Telnect eller ett CRM. Det testar utkast, kundmatchning och dubblettnycklar, men ersätter inte ett test av leverantörens händelsekontrakt.