1. Skapa din app

Se till att slå på Phone-ramverket som initiering när du skapar din app.

Lägg till ett capabilities-objekt i din apps config json för att välja hur Upsales hanterar samtal:

"capabilities": {
   "pickupHook": true,
   "hangupHook": true
}

• pickupHook: Upsales väntar på din Pickup-webhook innan samtalet visas som besvarat. Utan den visas samtalet som besvarat 4 sekunder efter att det har startat.
• hangupHook: Upsales stänger samtalet när din app skickar Hangup-webhooken.
• useCallToLinks: telefonnummer i Upsales blir länkar med det här värdet som prefix (till exempel "tel:"), så att användarens dator ringer upp samtalet. Upsales skickar /initiate i stället för /call.
• noRecordings: Upsales visar aldrig inspelningsspelaren för dina samtal.

Läs om phoneCalls i Upsales API

Din app behöver göra anrop till Upsales API för dina användares räkning för att lista och uppdatera phoneCalls-objekt.

2. Endpoints som din app ska lyssna på

Som du vet från introduktionen till appar i Upsales gör vi anrop till din app för att tala om att den används. En telefoniapp har följande endpoints att lyssna på.

/ongoing

För att kontrollera om det finns några pågående samtal

/call

När användaren startar ett nytt samtal

/initiate

När användaren klickar på ett telefonnummer och din app använder useCallToLinks. Anropets body innehåller number, clientId, contactId och objektet related. Upsales skapar inget samtal för /initiate: din app skapar det med phoneCalls-API:et och skickar Calling-webhooken.

/hangup

När användaren lägger på

/recording

För att spela upp en inspelning av samtalet (om det finns en). Upsales visar spelaren när samtalet har en conversationUrl, skickar det värdet till din app som id och spelar upp ljudet som din app returnerar.

3. Webhooks som din app ska skicka

För en smidig användarupplevelse ser du till att din app meddelar oss följande händelser.

Pickup-webhook

När ett samtal har besvarats

Hangup-webhook

Om samtalet avslutades utanför Upsales

Calling-webhook

När ett samtal som startades med /initiate rings upp. Skicka händelsen phone.calling med samtalsobjektet som data.

Error-webhook

När ett samtal inte kunde genomföras. Skicka händelsen phone.error: Upsales visar ett fel för användaren och stänger samtalet.

Skicka de här två på samma sätt som Pickup-webhooken.

Feedback? Har du frågor, eller har vi missat något som skulle göra din telefoniapp ännu bättre? Hör av dig till apps@upsales.com