Mokapenguiden

3CX

3CX kopplar telefonisystemet till Mokapen för kontakt-popup, samtalslogg och, om du konfigurerar det, click-to-call. Mokapen blir inte telefonisystemet: det genererar en API-nyckel och en XML-mall som du laddar in i 3CX-administrationen. Därifrån frågar 3CX Mokapen vem numret tillhör, och Mokapen kan skriva samtalsanteckningen på kontakt eller företag.

Översikt: Integrationer.

Krav

• En 3CX-installation där du kan öppna Admin → Integrations → CRM och ladda en mall.
• Mokapen-plan Medium.
• För click-to-call dessutom: 3CX-plan med Call Control / WebAPI (Enterprise), en 3CX-värd som Mokapen kan nå, och en anknytning mappad till användaren som klickar.

API-nyckel och mall

Användarmenyn → Integrationer → 3CX. Mokapen visar API-nyckeln för CRM-mallen: som Basic auth-användarnamn, eller i headern X-Api-Key. Ladda ner XML-mallen. Nyckeln är redan insatt som standardvärde. Ladda den i 3CX Admin → Integrations → CRM.

På sidan finns också bas-URL för CRM API: det är adressen mallen anropar. Om 3CX ligger bakom ett nätverk som inte når Mokapen öppnas inte popupen ens med mallen inläst.

Du kan regenerera nyckeln vid spara. Den förra slutar fungera: du måste ladda om mallen, eller uppdatera nyckeln som redan klistrats in i 3CX. Att lämna gamla nyckeln i telefonisystemet ger autentiseringsfel, inte en andra koppling.

Samtalsanteckningar och click-to-call

Två växlar styr beteendet mot adressboken:

• Spara samtalsanteckningar på kontakter och företag — i slutet av samtalet skriver Mokapen anteckningen på kortet som hittades.
• Tillåt att skapa kontakter från 3CX om numret är okänt — om numret inte finns i adressboken skapar Mokapen kontakten. Stäng av om telefonisystemet tar emot generisk trafik (växel på webbplats, servicenummer): annars blir varje okänd ett kort.

Click-to-call är separat. Du behöver 3CX-värden (FQDN) och WebAPI / Call Control-nyckel. Utan nyckel säger Mokapen att Call Control-nyckeln inte är konfigurerad. Utan värd säger den att FQDN saknas. Utan mappning vet inte samtalet vilken anknytning som ska ringa.

Mappningen är en rad per person, i formen extension=user_id (exempel 102=15). Den behövs både för att föra samtalsanteckningen till rätt användare och för click-to-call. Om din användare saknar rad säger Mokapen att ingen anknytning är mappad. Ett normalt klick ringer via 3CX; Shift, Ctrl eller Alt tillsammans med klicket öppnar enhetens uppringare.

Om 3CX avvisar begäran, kontrollera i ordning FQDN, Call Control-nyckel och anknytning. Meddelandet på sidan är att 3CX inte accepterade samtalet.

När popupen inte visas

• Mallen laddades inte in, eller laddades innan nyckeln regenererades.
• Inkommande nummer matchar inte en telefon i adressboken och automatisk skapelse är av. Popupen har inget kort att öppna.
• Du letar efter videosamtalet för mötet. 3CX sätter inte Meet eller Teams på möteskortet.