Custom contact lookup

Auteur Ellinor Niklasson

Laatst bijgewerkt: 19 december, 2024 door Ellinor Niklasson

Custom contact lookup

Klantscenario

Een klant heeft een CRM-systeem en wil dat de contactgegevens bij inkomende gesprekken worden weergegeven in de desktop-app voor de agent die de gesprekken aanneemt.                                                  

                                                               

Aan de slag                                                         

Vereisten           

* Een API toegangspunt om uw CRM-contacten te bereiken, bijvoorbeeld www.yourCRM.com/customers/contact?= {system.caller}.

* Toegangstoken voor de API (indien vereist door uw systeem)".

Klik op de onderstaande tabbladen voor een stapsgewijze handleiding over het ontvangen van bellerinformatie op uw desktop-app:

Een nieuwe webhook maken

Deze handleiding begeleidt u door het proces van het maken van een nieuwe webhook, het toewijzen ervan aan specifieke gebruikers en het toevoegen van een oproepwidget om bellerinformatie effectief te presenteren.

  1. Meld u aan bij de beheerdersportal.
  2. Klik op Gebruikers.
  3. Navigeer naar Webhooks.
  4. Klik rechtsboven op de pagina op het tabblad "Manage webhooks".
  5. Klik vervolgens op "Create a new webhook".

 
 

Webhook-details toevoegen

  1. Naam: Geef een aangepaste naam die de functie van de webhook beschrijft. Deze naam helpt u om deze later te identificeren wanneer u deze aan gebruikers toewijst.
  2. Beschrijving: Voeg een beschrijving toe die uitlegt wat de Webhook doet. Dit is handig voor uw collega's om het doel ervan te begrijpen.
  3. Event: Selecteer de event waarvoor de webhook wordt geactiveerd. Als u bijvoorbeeld wilt dat de informatie beschikbaar is voordat het gesprek begint, kiest u de "ringing" event.
  4. URL: Voer de URL in die verbinding maakt met het CRM- systeem. Gebruik de systeemvariabele {system.caller} om het telefoonnummer van de beller op te halen voor opzoekingen in het CRM. Gebruik de GET-methode om dit weer te geven in de Desktop-client. 
  5. HTTP-headers (optioneel): Als uw systeem autorisatie vereist, voert u hier de benodigde gegevens in.
  6. Variabele retourneren: Geef een variabelenaam (bijv. crm_contact) op die het resultaat van de GET-aanvraag opslaat. Deze variabele wordt later gebruikt in een Call Widget. 
  7. Time-outs: De zoekopdracht wordt beëindigd als er geen antwoord wordt gevonden in het systeem van de derde partij. 
  8. Zodra alle velden zijn ingevuld, klikt u op 'Aanmaken'.
  9. Uw webhook is nu gemaakt en klaar voor gebruik.
 
 

De webhook aan gebruikers toewijzen

Nadat u de webhook hebt aangemaakt, kiest u de gebruikers die er baat bij zullen hebben:

  1. Markeer de gebruiker onder Gebruikers in de beheerdersportal.
  2. Klik in het rechterpaneel op "Webhook toevoegen".
  3. Zoek en selecteer in het pop-upvenster dat verschijnt de webhook die u zojuist hebt gemaakt.
  4. Klik op 'Toevoegen' om het toe te wijzen aan de geselecteerde gebruiker.

 
 

Voeg een oproepwidget toe om bellerinformatie weer te geven en configureer de oproepwidget

Voeg een oproepwidget toe om bellerinformatie weer te geven

Met de webhook die is gemaakt en toegewezen aan een gebruiker willen we dat de agent de persoon ziet die belt. Om dit te doen willen we de beller op een presenteerbare manier weergeven. Afhankelijk van de API en hoe de data wordt verzonden, kan men dit op veel verschillende manieren doen, maar laten we een aanname doen.

{
voornaam: John,
achternaam: Doe,
Telefoonnummer: +4612345
bedrijf: : {
naam: Acme
}
}

Een oproepwidget maken en toewijzen aan een gebruiker:
 

  1. Ga naar Gebruikers.
  2. Klik op Oproepwidgets.
  3. Klik op 'Oproepwidgets beheren' in de rechterbovenhoek.
  4. Klik op Maak een nieuwe oproepwidget aan.
  5. Vul onder Geavanceerde instellingen de variabele in waarvan u een weergave wilt maken, voor dit voorbeeld {crm_contact}
  6. Klik op Inhoudsrij toevoegen. Vul de informatie in die geschikt is voor uw behoeften.
  7. Door de contextrijen te gebruiken en de opgeslagen variabele te gebruiken, kunnen we de widget aanpassen aan onze behoeften. In dit geval maken we drie inhoudsrijen.
  8. Onder de Titel kunt u de opgeslagen variabele gebruiken en aangeven welke delen van het antwoord u wilt gebruiken.
  9. Voeg onder Label een naam toe, zodat de gebruiker weet naar welke informatie hij kijkt. 
  10. Wanneer de widget is aangemaakt, klikt u op Widget maken.
  11. Markeer vervolgens de gebruikers in de tabelweergave die aan deze widget moeten worden toegevoegd.
  12. Klik in het menu aan de rechterkant op Widget toevoegen
  13. Markeer de widget die u zojuist hebt gemaakt en wijs deze toe aan de gebruikers.
  14. Klik vervolgens eenvoudig op Widget toevoegen

Bij hun volgende gesprek zien ze de informatie die uw webhook verzamelt, zichtbaar in het gespreksvenster.

 
 


Conclusie

U hebt nu met succes een Webhook gemaakt, een Call -widget geconfigureerd om bellerinformatie weer te geven en de Webhook en Call- widget toegewezen aan Gebruikers. Uw collega's kunnen nu profiteren van het gestroomlijnde proces en de verbeterde belleridentificatie tijdens gesprekken.

Informatie

Personal Webhooks is op gebruikersniveau en Advanced Nodes is op PBX- en wachtrijniveau. In ons FAQ-artikel Advanced Nodes ‍leest u meer over hoe u Advanced Nodes in uw PBX kunt gebruiken.