Andere telefooncentrale

Werk je niet met Voys, maar met een andere provider of een eigen telefooncentrale? Laat die bij elk gesprek een melding sturen naar Qontivo. Gaat de telefoon van een medewerker over, dan ziet die meteen wie er belt, wat er voor die klant openstaat en wat je kunt doen.

Waar vind je het

Bij Integraties, in de kaart Andere telefooncentrale. Alleen een Beheerder kan de koppeling maken.

Zo werkt het

1. Klik op Webhook-adres maken. Je ziet een adres en een geheim. Die zie je alleen nu: kopieer ze.
2. Stel in je telefooncentrale in dat die bij elk gesprek een melding stuurt naar dit adres (een POST met JSON).
3. Geef elke medewerker bij Instellingen, Gebruikers het nummer van zijn toestel.
4. Noemt je centrale de velden anders dan hieronder, vul dan bij Velden in welk veld wat is. Na de eerste melding zie je welke velden er binnenkwamen.

Het formaat

Elke melding is een JSON-object, met deze velden:

Veld	Wat	Voorbeeld
call_id	Kenmerk van het gesprek, hetzelfde bij elke melding over dat gesprek	"a1b2c3"
status	ringing (gaat over), answered (opgenomen) of ended (beëindigd)	"ringing"
direction	inbound (inkomend) of outbound (uitgaand); zonder: inkomend	"inbound"
number	Het nummer van de klant	"+31201234567"
extension	Het toestel van de medewerker waar het overgaat of dat opneemt	"201"
caller_name	De naam van de beller, als de centrale die kent	"Jansen B.V."
timestamp	Wanneer het gebeurde (ISO 8601 of seconden sinds 1970); zonder: wanneer de melding binnenkwam	"2026-10-14T10:03:20Z"
duration	Bij ended: hoe lang er gesproken is, in seconden	180
outcome	Bij ended: completed (afgerond), no-answer (niet opgenomen), busy (in gesprek), cancelled (opgehangen voor opnemen) of failed (mislukt); zonder: afgerond als het is opgenomen	"completed"
recording_url	Het adres van de opname (alleen https), bij ended of in een eigen melding daarna met alleen call_id	"https://…/opname.wav"

Een voorbeeld:

{
  "call_id": "a1b2c3",
  "status": "ringing",
  "direction": "inbound",
  "number": "+31201234567",
  "extension": "201"
}

Gebruikt je centrale andere woorden voor de status, de richting of de uitkomst, zoals RING of in, zet die dan bij Eigen woorden. Een veld binnen een veld schrijf je met een punt, zoals caller.number.

Ondertekenen

Onderteken elke melding met het geheim: zet in de header X-Qontivo-Signature de tekst sha256= met daarachter de HMAC-SHA256 van de hele body, met het geheim als sleutel, in kleine letters hexadecimaal. Een melding zonder goede ondertekening wordt geweigerd (401).

Kan je centrale niet ondertekenen, zet dan Alleen ondertekende meldingen aannemen uit. Dan beschermt alleen het geheime adres de koppeling.

Antwoorden

• 200: ontvangen.
• 401: de ondertekening klopt niet.
• 404: het adres bestaat niet, of de koppeling staat uit.
• 413: de melding is groter dan 64 kB.
• 422: geen JSON-object, of het kenmerk of de status ontbreekt. Het antwoord zegt welk veld.

Goed om te weten

• Qontivo bewaart van een melding alleen de namen van de velden, niet wat erin staat. Zo zie je bij Velden welke er zijn.
• Na ended staat het gesprek bij de relatie, met de duur, de uitkomst en wie het aannam (het toestel bij answered, of bij een uitgaand gesprek het toestel dat belde). Een onbekend nummer wordt een suggestie, net als bij Voys. Interne gesprekken en afgeschermde nummers worden niet vastgelegd. Wil je dat niet, zet dan Gesprekken vastleggen bij de relatie uit.
• Wat de meldingen van een gesprek zeggen, bewaart Qontivo alleen tot het gesprek is vastgelegd (en hooguit een dag).
• Opnames uitschrijven en samenvatten staat standaard uit. Zet je het aan en stuurt je centrale recording_url mee, dan schrijft Qontivo de opname uit en zet een korte samenvatting als notitie bij het gesprek. Het adres wordt versleuteld bewaard en gewist zodra dat klaar is; de opname zelf blijft bij je centrale. Opnemen mag alleen als je bellers dat vooraf weten en met een goede reden (AVG).
• Bellen doe je in Qontivo met de telefoonlinks; die openen je eigen telefoon of softphone.