Mokapen-guiden

3CX

3CX forbinder centralen med Mokapen til kontakt-popup, opkaldsjournal og — hvis du konfigurerer det — click-to-call. Mokapen bliver ikke centralen: den genererer en API-nøgle og en XML-skabelon, du uploader i 3CX-admin. Derfra spørger 3CX Mokapen, hvem nummeret er, og Mokapen kan skrive opkaldsnoten på kontakt eller virksomhed.

Overblik: Integrationer.

Krav

• En 3CX-installation, hvor du kan åbne Admin → Integrations → CRM og uploade en skabelon.
• Mokapen-plan Medium.
• Til click-to-call desuden: 3CX-plan med Call Control / WebAPI (Enterprise), en 3CX-host som Mokapen kan nå, og en internnummer mappet til den bruger, der klikker.

API-nøgle og skabelon

Brugermenu → Integrationer → 3CX. Mokapen viser den API-nøgle, der skal bruges i CRM-skabelonen: som brugernavn i Basic auth, eller i headeren X-Api-Key. Download XML-skabelonen. Nøglen er allerede indsat som standardværdi. Upload den i 3CX Admin → Integrations → CRM.

På siden finder du også basis-URL'en til CRM-API'erne: det er den adresse, skabelonen kalder. Hvis 3CX er bag et netværk, der ikke kan nå Mokapen, åbnes popup'en ikke, selv med skabelonen uploadet.

Du kan regenerere nøglen ved gem. Den forrige gælder ikke længere: skabelonen skal genuploades, eller nøglen allerede indsat i 3CX skal opdateres. At lade den gamle nøgle blive i centralen giver godkendelsesfejl — ikke en anden forbindelse.

Opkaldsnoter og click-to-call

To kontakter afgør adfærden mod adresselisten:

• Gem opkaldsnoter på kontakter og virksomheder — ved opkaldets slutning skriver Mokapen noten på det fundne kort.
• Tillad oprettelse af kontakter fra 3CX, hvis nummeret er ukendt — hvis nummeret ikke er i adresselisten, opretter Mokapen kontakten. Sluk den, hvis centralen modtager generisk trafik (hovedcentral, service-numre): ellers bliver hver ukendt et kort.

Click-to-call er separat. Du skal bruge 3CX-host (FQDN) og WebAPI / Call Control-nøgle. Uden nøgle siger Mokapen, at Call Control-nøglen ikke er konfigureret. Uden host siger den, at FQDN mangler. Uden mapping ved opkaldet ikke, hvilket internnummer der skal ringe.

Mappingen er én række pr. person i formen internnummer=user_id (eksempel 102=15). Den bruges både til at tilskrive opkaldsnoten til den rigtige bruger og til click-to-call. Hvis din bruger ikke har en række, siger Mokapen, at der ikke er et mappet internnummer. Et almindeligt klik ringer med 3CX; Shift, Ctrl eller Alt sammen med klik åbner enhedens dialer.

Hvis 3CX afviser anmodningen, tjek i rækkefølge FQDN, Call Control-nøgle og internnummer. Beskeden på siden er, at 3CX ikke accepterede opkaldet.

Når popup'en ikke kommer

• Skabelonen er ikke uploadet, eller den blev uploadet før nøglegenenereringen.
• Det indkommende nummer matcher ikke en telefon i adresselisten, og automatisk oprettelse er slukket. Popup'en har intet kort at åbne.
• Du leder efter videoopkaldet på aftalen. 3CX sætter ikke Meet eller Teams på aftalekortet.