Hur integrerar jag Rinkel med mina system via webhooks?

Obs: Webhooks är tekniska. Det rekommenderas starkt att anlita en utvecklare (eller vara en själv) eller ha en IT-bakgrund för att implementera webhooks i dina befintliga verktyg. Naturligtvis är du fri att experimentera och investera tid i att utforska webhooks även om du inte har någon IT-bakgrund ännu.

I denna FAQ kommer vi att besvara följande frågor:

• Varför behöver jag en webhook?

• Hur ställer jag in en webhook?

• Vilken data skickas i en webhook?

• Vilka säkerhetsåtgärder finns det för webhooks?

• Vad ska jag göra om min webhook inte fungerar?

Du hittar webhooks i Webbtelefon.

Varför behöver jag en webhook?

Webhooks är ett effektivt sätt att integrera olika tjänster med My Rinkel. Genom att använda webhooks kan du automatiskt utlösa vissa åtgärder eller uppdateringar i dina andra verktyg (som ett CRM, helpdesk eller rapportering) baserat på samtalshändelser i My Rinkel.

Till exempel: om du får ett nytt inkommande samtal kan en webhook omedelbart skicka denna information till din URL-slutpunkt, som sedan automatiskt skapar en ny biljett i ditt helpdesksystem.

Hur ställer jag in en webhook?

För att ställa in en webhook måste du specificera en URL-slutpunkt i din applikation dit Rinkel kan skicka data. Denna slutpunkt måste vara tillgänglig via internet och kunna ta emot POST-begäran. När du har ställt in slutpunkten kan du ge dess URL till Rinkel via Webbtelefonen genom att följa följande steg:

1. Gå till Rinkel Webphone.

2. Klicka på kugghjulsikonen uppe till vänster och gå till Integrationer.

3. Klicka på den webhook du vill ställa in (inkommande samtal, utgående samtal, början av ett samtal eller slutet av ett samtal).

4. Ange URL:en för din slutpunkt.

5. Klicka på testa URL för att kontrollera att URL:en är giltig.

6. Lägg till en beskrivning av webhoken (valfritt).

7. Klicka på Spara för att spara dina ändringar.

Se till att du tillåter förfrågningar från Rinkel-domänen för att framgångsrikt ta emot webhook-notifikationer.

Vilken information skickas i en webhook?

• Inkommande samtal

• Utgående samtal

• Början av ett samtal

• Slutet av ett samtal

Inkommande samtal:

Denna webhook aktiveras när ett inkommande samtal har gjorts men ännu inte besvarats.

id: Samtalets unika ID

datetime: Datum och tid för samtalet

to: Uppringarens nummer

from: Telefonnumret som blev uppringt

Utgående samtal:

Denna webhook aktiveras när du ringer ett samtal från ditt företags Rinkel-nummer, men samtalet ännu inte besvarats.

id: Samtalets unika ID

datetime: Datum och tid för samtalet

to: Ringarens nummer

from: Telefonnumret som blev uppringt

Början av ett samtal:

Denna webhook aktiveras när du eller en kollega besvarar det inkommande samtalet, eller när personen du försöker ringa svarar.

id: Samtalets unika ID

datetime: Datum och tid för samtalet

answeredBy: Användaren som besvarade samtalet (visas av ett unikt användar-ID)

choice: Varje val gjort i röstmenyn (endast tillgängligt för inkommande samtal)

Slutet på ett samtal:

Denna webhook aktiveras när ett samtal avslutas, av en av de sex tillgängliga anledningarna.

id: Samtalets unika ID

datetime: Datum och tid för samtalet

cause: Anledningen till att samtalet avslutades (6 alternativ: obesvarat, besvarat, blockerat, röstmeddelande, callcenter, utanför öppettider)

Vilka säkerhetsåtgärder finns det för webhooks?

Webhooks är säkrade genom olika mekanismer. Den data som skickas av webhook är i JSON-format, vilket är ett vanligt, läsbart dataformat som lätt kan säkras.

Kommunikationen mellan Rinkel och din applikation sker via HTTPS, vilket krypterar data under överföringen.

Dessutom bör du bara acceptera förfrågningar från pålitliga källor, såsom Rinkel-domänen.

Vad ska jag göra om min webhook inte fungerar?

Om din webhook inte fungerar som förväntat, följ dessa vanliga steg för att lösa problemet:

1. Kontrollera din slutpunkt: Se till att din slutpunkts URL är korrekt och åtkomlig via internet.

2. Kontrollera HTTP-metoden: Bekräfta att din slutpunkt är inställt för att ta emot POST-förfrågningar.

3. Undersök förfrågan och svaret: Använd verktyg för att fånga den inkommande förfrågan och kolla efter fel. Se också till att din applikation returnerar en framgångsrik HTTP-statuskod (200 OK) för att bekräfta mottagningen av datan.

4. Kontrollera Rinkels domän: Se till att du accepterar förfrågningar från Rinkels domän.

Om du fortfarande har problem, kopiera felmeddelandena du får och skicka dem till Rinkels supportteam. Vi hjälper dig gärna med att lösa problemet.