De Mokapen-gids

3CX

3CX koppelt de telefooncentrale aan Mokapen voor het contactpopup, het beljournaal en, als je het configureert, click-to-call. Mokapen wordt niet de centrale: het genereert een API-sleutel en een XML-template die je in de 3CX-admin laadt. Vanuit daar vraagt 3CX aan Mokapen wie het nummer is, en Mokapen kan de belnotitie op contact of bedrijf schrijven.

Overzicht: Integraties.

Vereisten

• Een 3CX-installatie waarvan je Admin → Integrations → CRM kunt openen en een template kunt laden.
• Mokapen-plan Medium.
• Voor click-to-call, bovendien: 3CX-plan met Call Control / WebAPI (Enterprise), een 3CX-host die Mokapen kan bereiken, en een toestel gemapt op de gebruiker die klikt.

API-sleutel en template

Gebruikersmenu → Integraties → 3CX. Mokapen toont de API-sleutel voor het CRM-template: als gebruikersnaam van Basic auth, of in de header X-Api-Key. Download het XML-template. De sleutel staat al als standaardwaarde. Laad het in 3CX Admin → Integrations → CRM.

Op de pagina vind je ook de basis-URL van de CRM-API's: dat is het adres dat het template aanroept. Als 3CX achter een netwerk zit dat Mokapen niet bereikt, opent het popup niet, ook met geladen template.

Je kunt de sleutel opnieuw genereren bij opslaan. De vorige geldt niet meer: laad het template opnieuw, of werk de al geplakte sleutel in 3CX bij. Een oude sleutel in de centrale laten staan geeft authenticatiefouten, geen tweede koppeling.

Belnotities en click-to-call

Twee schakelaars bepalen het gedrag richting het adresboek:

• Belnotities opslaan op contacten en bedrijven — aan het einde van het gesprek schrijft Mokapen de notitie op de gevonden kaart.
• Contactaanmaak vanuit 3CX toestaan als het nummer onbekend is — als het nummer niet in het adresboek staat, maakt Mokapen het contact. Zet uit als de centrale algemeen verkeer ontvangt (hoofdcentrale, beleefdheidsnummers): anders wordt elke onbekende een kaart.

Click-to-call is apart. Nodig zijn 3CX-host (FQDN) en WebAPI / Call Control-sleutel. Zonder sleutel zegt Mokapen dat de Call Control-sleutel niet is geconfigureerd. Zonder host dat de FQDN ontbreekt. Zonder mapping weet het gesprek niet welk toestel moet rinkelen.

De mapping is één regel per persoon, in de vorm toestel=user_id (voorbeeld 102=15). Die dient zowel om de belnotitie aan de juiste gebruiker toe te schrijven als voor click-to-call. Heeft jouw gebruiker geen regel, zegt Mokapen dat er geen gemapt toestel is. Een normale klik belt met 3CX; Shift, Ctrl of Alt samen met de klik opent de dialer van het apparaat.

Als 3CX het verzoek weigert, controleer in volgorde FQDN, Call Control-sleutel en toestel. Het bericht op de pagina is dat 3CX de oproep niet heeft geaccepteerd.

Wanneer het popup niet verschijnt

• Het template is niet geladen, of is geladen vóór het opnieuw genereren van de sleutel.
• Het inkomende nummer komt niet overeen met een telefoon in het adresboek en automatische aanmaak staat uit. Het popup heeft geen kaart om te openen.
• Je zoekt de videogesprek van de afspraak. 3CX zet Meet of Teams niet op de afspraakkaart.