Asterisk koppelen aan Xcellerate OPS: pop-ups, klik-om-te-bellen en gesprekslog

Koppel je eigen Asterisk aan Xcellerate OPS en je ziet bij elke oproep wie er belt, elk gesprek komt op de CRM-tijdlijn van je klant en je team belt klanten rechtstreeks vanuit OPS. Deze gids is voor beheerders van MSP's en dienstverlenende kmo's met een zelfbeheerde Asterisk (versie 16 of hoger).

TL;DR

• OPS maakt verbinding met je Asterisk via AJAM over HTTPS, met een manager-gebruiker die alleen het adres van OPS toelaat.
• Je krijgt een pop-up bij inkomende oproepen, klik-om-te-bellen (je eigen toestel gaat eerst over) en een gesprekslog op de CRM-tijdlijn.
• Optioneel: opnames uit een beveiligde HTTPS-map en een nachtelijke afstemming met je CDR-database.

Voor je begint

• Je bent beheerder van de OPS-werkruimte, of je rol mag de telefonie-instellingen beheren.
• Een Asterisk-beheerder die http.conf, manager.conf en het dialplan kan aanpassen. Asterisk 16 of hoger; het dialplan-fragment is getest op 18 en 20.
• OPS moet je Asterisk via HTTPS kunnen bereiken. Een centrale die OPS niet bereikt, kun je nog niet koppelen.
• Het adres van OPS voor je firewall, dat op de telefoniepagina staat.

Telefonie is een basisfunctie en zit in elk abonnement.

Stap 1: bereid Asterisk voor

AJAM over HTTPS

Zet in http.conf:

enabled = yes
tlsenable = yes
tlsbindaddr = 0.0.0.0:8089

Een manager-gebruiker voor OPS

Maak in manager.conf een gebruiker met een lang geheim dat alleen het OPS-adres toelaat:

deny = 0.0.0.0/0.0.0.0
permit = <OPS-adres>/255.255.255.255
read = call,cdr,reporting,user
write = originate

Laat het OPS-adres in je firewall door naar deze poort.

Optioneel: opnames en CDR

• Voeg de opnamemacro's van OPS (ops-recording en ops-hangup) uit het gepubliceerde dialplan-fragment toe aan je inkomende en uitgaande contexten. Verander de bestandsnamen niet.
• Deel de monitor-map (/var/spool/asterisk/monitor) alleen-lezen via HTTPS, met basic auth en een IP-allowlist.
• Voor de nachtelijke afstemming: leestoegang tot je CDR-database, bijvoorbeeld mysql:host=…;dbname=asteriskcdrdb, tabel cdr.

OPS zet opnemen nooit zelf aan. Moet je een opname aankondigen, doe dat dan in het dialplan, voor de opname start. Herlaad Asterisk.

Stap 2: voeg Asterisk toe in OPS

Ga naar de telefonie-instellingen (Settings → Data and security → Telephony), klik op Telefooncentrale toevoegen, kies Asterisk en geef een naam.

De pagina Telefonie met een keuzelijst voor de telefooncentrale, een naamveld en de melding dat er nog geen telefooncentrale gekoppeld is.

Vul Asterisk address (https://pbx.example.com:8089), Manager user (AMI/AJAM), Manager secret in. Voor opnames: Recordings base URL, Recordings user, Recordings password. Voor de afstemming: CDR database DSN, CDR database user, CDR database password. Gebruik je een zelfondertekend certificaat, vink dan Dit certificaat accepteren aan. Sla op.

Stap 3: test, koppel toestellen en schakel in

1. Klik op Verbinding testen. Je ziet dat de centrale via AJAM antwoordt en of er een opnamebron ingesteld is.
2. Toestellen worden niet geïmporteerd. Typ elk toestelnummer en kies bij Hoort bij wie het gebruikt. Voor een belgroep voeg je iedereen toe met Persoon toevoegen. Een toestel zonder persoon toont geen pop-up.
3. Klik op Inschakelen en doe een testgesprek.

Wat er gebeurt na het koppelen

• Inkomende oproepen: OPS leest de gespreksgebeurtenissen van Asterisk in korte rondes. Rechtsonder verschijnt wie er belt, met knoppen om het contact of bedrijf te openen, een nieuw ticket met het nummer te starten of het nummer als contact toe te voegen. Een doorverbonden gesprek blijft één gesprek.
• Klik-om-te-bellen: met een eigen toestel (geen belgroep) belt Asterisk eerst jouw toestel, daarna de klant. OPS draagt zelf geen audio. Na het gesprek noteer je hoe het verliep.
• Gesprekslog: elk gesprek komt op de CRM-tijdlijn van contact en bedrijf, gekoppeld aan de meest recente open deal. Niet op tickets. Onbekende nummers komen in een aparte lijst; OPS maakt nooit zelf contacten aan.
• Gemiste oproepen geven een melding aan wie zijn toestel rinkelde, anders aan de eigenaar van de deal.
• Opnames worden na het gesprek opgehaald, aan het juiste gesprek gekoppeld en in OPS afgespeeld, met een log van wie luisterde. Gemiste oproepen worden niet opgehaald.
• Afstemming: met een CDR-database vult OPS elke nacht aan.

Goed om te weten

• Alleen HTTPS: OPS stuurt manager-gegevens nooit over gewoon HTTP.
• Opnames haalt OPS alleen op uit een HTTPS-map.
• Uitgaande gesprekken start OPS in de context from-internal.
• Opnemen op twee kanalen kost dubbel zoveel schijfruimte, maar laat gespreksamenvattingen beller en medewerker uit elkaar houden. Gespreksamenvattingen staan standaard uit (instellingen voor AI) en kosten AI-credits.
• OPS verwijdert geen opnames op je Asterisk. Het manager-geheim kun je na opslaan niet meer lezen.

Probleemoplossing

• "The base URL is not HTTPS." Zet het AJAM-eindpunt achter TLS.
• "The PBX did not answer over AJAM: …" Controleer of de manager-gebruiker bestaat, of de permit-regel het OPS-adres bevat en of de poort ervoor openstaat.
• "No recording source is configured." Deel de monitor-map via beveiligde HTTPS en pas het dialplan-fragment toe.
• Geen opnames, geen fout: de bestandsnaam in het dialplan is aangepast.

Aan de slag

Wil je je eigen Asterisk laten samenwerken met je CRM en servicedesk? Start gratis. Lees ook over de Europese integraties van OPS en sales en facturatie.