För att bygga en fungerande telefoniapp behöver din app använda Upsales API och phoneCall-endpointen.

Varje anrop behöver en API-nyckel i query-parametern token, till exempel https://integration.upsales.com/api/v2/phoneCall?token=YOUR_API_KEY. Läs mer i Så skapar du en API-nyckel (på engelska).

Hämta en lista med samtal genom att söka efter phoneCall-objekt

GET https://integration.upsales.com/api/v2/phoneCall

Hämta ett enskilt phoneCall-objekt

GET https://integration.upsales.com/api/v2/phoneCall/:id

Uppdatera ett phoneCall-objekt

PUT https://integration.upsales.com/api/v2/phoneCall/:id

Lägg till ett samtal i Upsales

POST https://integration.upsales.com/api/v2/phoneCall

Radera ett phoneCall-objekt

DELETE https://integration.upsales.com/api/v2/phoneCall/:id

När du lägger till ett samtal måste anropets body innehålla användaren, kontaktpersonen och företaget (client):

{
  "user": { "id": 1 },
  "contact": { "id": 2 },
  "client": { "id": 3 },
  "phoneNumber": "+46701234567",
  "durationInS": 120,
  "externalId": "call-123"
}

Övriga fält är valfria: phoneNumber, date, durationInS (längd i sekunder), status (tal), type (text, högst 45 tecken), externalId (ditt eget id för samtalet, högst 512 tecken) och conversationUrl (en länk till inspelningen eller samtalet, högst 512 tecken). När du uppdaterar ett samtal skickar du bara de fält du vill ändra.

Anropen är begränsade per API-nyckel. Standardgränserna är 200 anrop per 10 sekunder, 6 000 per 10 minuter och 20 000 per timme, och för POST-, PUT- och DELETE-anrop dessutom 2 000 per 10 minuter och 5 000 per timme. Ett anrop över en gräns får HTTP-status 429 (Too many requests). Din app ska då vänta och försöka igen.

Mer information om Upsales API finns i dokumentationen