När en användare klickar på ett telefonnummer i Upsales öppnas telefonwidgeten, Upsales skapar en samtalspost och din app får ett anrop till följande endpoint
/call
Anropet är en POST med en JSON-body, och appens endpoint måste använda HTTPS. Body:n har samma fält som alla anrop till appar (se Anropets body). Använd user för att ta reda på vilken användare som ringer.
Anropets body.data är samtalet som Upsales just skapade, i samma format som phoneCall-objektet i Upsales API:
"data": {
"id": 450,
"phoneNumber": "+1 555 8772537",
"client": { "id": 123, "name": "Company name" },
"contact": { "id": 345, "name": "Contact name" },
"user": { "id": 1, "name": "User name" },
"status": 0,
"durationInS": 0,
"related": [],
...
}
-
id: samtalets ID. Använd det när du uppdaterar samtalet via Upsales API. -
phoneNumber: numret som ska ringas. -
clientochcontact: företaget och kontaktpersonen som numret hör till, ellernullom det inte finns någon. -
user: användaren som ringer. -
date: när samtalet startades. -
type: appens ID. -
related: en lista med aktiviteter, möten, försäljningar eller affärsmöjligheter som är kopplade till samtalet, var och en medid,typeochname.
Använd det här anropet för att starta samtalet. Svara inom 30 sekunder med status 200 eller 201 och en JSON-body. Om appen svarar med någon annan status eller inte svarar i tid raderar Upsales samtalsposten och användaren ser meddelandet ”Kunde inte ringa. Verifiera kopplingen till integrationen”.