Vidarekoppling av samtal

Kom igång

För att ta emot samtal med 46elks behöver du:

1. Ett konto på 46elks
2. Ett virtuellt telefonnummer

Detta vill vi uppnå

1. Alla inkommande samtal kommer in via ett och samma telefonnummer
2. Samtalet kopplas sedan vidare till en lista med nummer
3. Den som svarar först får samtalet

Format

När någon ringer till ditt virtuella nummer kommer vårt API titta i en parameter som vi kallar för voice_start.

Denna parameter innehåller instruktioner från dig som utvecklare, som talar om vad API:et ska göra. Instruktionerna kan antingen anges i form av en webhook (en URL till ett webbaserat script) eller som en JSON-formaterad sträng.

För att instruera API:et att vidarekoppla ett samtal kommer vi använda en s.k. call action som heter connect. I denna kommer du få ange de nummer som samtalet ska kopplas vidare till. Numren bör vara formaterade enligt E.164, t.ex. +46700000001 istället för 0700000001.

Bygg din applikation

Nu är det dags att konfigurera voice_start. Vi ska börja med att ange en JSON-formaterad sträng och därefter sen bygger vi en webhook.

Att konfigurera voice_start är enkelt och vi har en kort guide för hur du gör det. Ha gärna guiden öppen i en egen flik så att du snabbt kan referera till den om du behöver vägledning.

JSON

1. Ange följande JSON-sträng i voice_start med hjälp av guiden och byt ut alla telefonnummer till de personer du vill ringa upp. Du kan ange hur många nummer du vill och minst ett nummer krävs.

2. Ring ditt virtuella nummer och se vem som svarar först.

Vägledning om det inte skulle fungera

• Kontrollera att du använder ett korrekt JSON-format
• Kontrollera att numren du angivit är korrekta och formaterade enligt E.164, t.ex. +46700000001 istället för 0700000001.
• Kontakta vår support. Vi hjälper dig gärna.

Det finns vissa begränsningar när du anger en JSON-sträng direkt i voice_start. För mer komplexa lösningar behöver du bygga din applikation med separata script och därför ska vi nu bygga en enkel webhook.

Webhook

En webbhook är (som nämnt tidigare) en URL till ett webbaserat script som returnerar en JSON-sträng med instruktioner till API:et (jämfört med att ange JSON-strängen direkt i voice_start som i föregående exempel).

För att bygga en webhook behöver du:

1. En server där du kan köra din kod ifrån (t.ex. ett webhotell)
2. Ett domännamn (t.ex. din-hemsida.se)

Så här bygger du din webhook:

1. Skapa en ny fil som du döper till connect.php

2. Ange följande kod i din fil:

   Vi bygger denna webhook med PHP. Principen är dock densamma om du vill använda ett annat programmeringsspråk.

3. Ladda upp filen på din serven så att den är nåbar via http://yourapp.example/connect.php

4. Ange URL:en http://yourapp.example/connect.php i voice-start (URL:en ska ersätta den JSON-sträng du angav tidigare)

5. Ring ditt virtuella nummer och se vem som svarar först

Scriptet du just byggde genererar exakt samma JSON-sträng som i tidigare exempel. Fördelen med denna webhook är att du nu enkelt kan bygga vidare på din applikation. Vill du att något ytterligare ska hända efter att du vidarekopplat samtalet? - Inga problem. Ange parametern next följt av ytterligare instruktioner i form av en ny webhook. Exempel:

Call Actions

Förutom connect som är grundläggande för vidarekoppling av samtal, kan du använda ytterligare call actions för att bygga vidare på din applikation. Här är några förslag:

• Bygg en telefonsvarare med play och record
• Bygg en telefonväxel med ivr
• Spela in hela samtalet med recordcall och mejla dig själv ljudfilen efter avslutat samtal

Pris

Vi debiterar dig för utgående samtal per påbörjat minut. Exempel:

• Ett samtal som är 2 minuter och 3 sekunder kommer debiteras för 3 minuter
• Ett samtal som är 5 sekunder kommer debiteras för 1 minut

Inkommande samtal till ditt virtuella nummer kostar bara när du vidarekopplar samtalet via connect (vilket vi har gjort i denna guide). De vidarekopplade samtalen kommer debiteras som vanliga utgående samtal.

Se vår prislista för mer info.

Behöver du hjälp?

Vår support är alltid öppen för dig och vi hjälper dig gärna.