De CRM-naar-voice-AI-workflow, uitgelegd zonder jargon

Een CRM koppelen aan een AI-stemagent komt neer op vier overdrachtsmomenten. Het CRM bepaalt wie er gebeld wordt. Het gespreksverzoek bevat wat de agent moet weten. De agent voert het gesprek. De resultaten komen terug op hetzelfde CRM-record. De meeste verwarring rond integraties ontstaat doordat die vier door elkaar lopen, of doordat niet duidelijk is welk systeem voor welk onderdeel verantwoordelijk is.

Deze gids loopt de volgorde door met een HubSpot-workflow als voorbeeld en laat daarna dezelfde cyclus zien voor elk CRM dat een webhook kan versturen.

Wat zijn de vier fasen van een CRM-naar-voice-AI-workflow?

Trigger, context, gesprek en terugschrijven:

1. Trigger. Een CRM-gebeurtenis (een ingevuld formulier, een gewijzigde dealfase, een bereikte datum) start een workflow die het voice-platform vraagt een gesprek te starten.
2. Context. Het gespreksverzoek bevat gegevens uit het CRM-record, zodat de agent het gesprek begint met de naam en situatie van het contact al bij de hand.
3. Gesprek. De agent praat en kan tijdens het gesprek CRM-records lezen of bijwerken.
4. Terugschrijven. Na het gesprek worden een samenvatting, gestructureerde uitkomstvelden, de transcriptie en de opname aan het CRM-record gekoppeld, en bepaalt de CRM-workflow wat er daarna gebeurt.

Wat start het AI-gesprek vanuit het CRM precies?

Een CRM-workflow start het gesprek op een van twee manieren: met een native workflowactie, of met een webhook die je eigen service omzet in een API-aanroep.

Native actie (HubSpot). De Retell AI-app in de HubSpot Marketplace voegt een actie Make a Phone Call toe aan HubSpot-workflows. Begin met een trigger die je al gebruikt: een formulierinzending, een nieuw record, een gewijzigde dealfase of een datumeigenschap zoals een afspraakdatum. Voeg een voorwaarde "Telefoonnummer is bekend" toe, zodat contacten zonder nummer nooit worden ingeschreven. Vul daarna drie velden van de actie in: From (de Retell-agent en het telefoonnummer), To (de telefoontoken van het contact) en optioneel Dynamic Variables als JSON. De workflow pauzeert tot het gesprek is afgelopen.

Webhook plus API (elk CRM). Kan je CRM vanuit een workflow een webhook versturen, laat die dan wijzen naar een kleine service die je zelf beheert. Die service roept de Create Phone Call API van Retell aan met vier dingen: from_number, to_number, de contextvelden in retell_llm_dynamic_variables en de CRM-record-ID in metadata. Retell slaat metadata op bij het gesprek en stuurt die mee in het call-object van latere webhooks. Zo vindt het resultaat de weg terug naar het juiste record.

Lijsten in plaats van gebeurtenissen. Voor een campagne gericht op een segment in plaats van één gebeurtenis exporteer je de lijst en voer je die uit als batchgesprekken: een CSV met een kolom voor telefoonnummers, waarbij elke extra kolom een variabele wordt die de agent kan gebruiken.

Voor elke route gelden twee voorwaarden. Aan het nummer waarmee je belt moet een uitgaande agent gekoppeld zijn, en de nummers die je belt moeten geldige E.164-nummers zijn (bijvoorbeeld +14155550123).

Hoe weet de agent wie hij belt?

Via dynamische variabelen: benoemde waarden zoals {{first_name}} of {{deal_stage}} die Retell invult voordat de agent begint te praten. Ze komen uit drie bronnen:

• Het gespreksverzoek. Alles wat de JSON van de HubSpot-actie of je API-aanroep meestuurt in retell_llm_dynamic_variables.
• Gesynchroniseerde contactvelden. Gebruik je de native CRM-contactsynchronisatie van Retell, dan krijgt een gesprek waarvan het nummer overeenkomt met een gesynchroniseerd contact automatisch de gekoppelde velden van dat contact als variabelen.
• Een opzoeking vóór het gesprek. Een pre-call-functie op de Workflow-pagina van de agent kan het CRM doorzoeken op het nummer en velden uit het antwoord aan variabelen koppelen. Bij uitgaande gesprekken draait die voordat Retell belt, zodat het contact niets van de opzoeking merkt.

Komt dezelfde naam uit meer dan één bron, dan gaat de waarde uit het verzoek voor op het gesynchroniseerde contactveld, en gaat alles wat de agent tijdens het gesprek verzamelt voor op beide.

Drie regels voorkomen de meeste gevallen waarin een agent een placeholder hardop voorleest:

• Stuur elke waarde als string, dus "42" en "true", niet 42 en true.
• Maak objecten plat. {{client.name}} wordt niet ingevuld; stuur in plaats daarvan client_name.
• Stel standaardwaarden in op agentniveau. Een variabele zonder waarde blijft in de prompt in zijn ruwe {{braces}}-vorm staan.

Wat gebeurt er tijdens het gesprek?

De agent voert het gesprek op basis van zijn prompt en variabelen, en kan tijdens het gesprek acties in het CRM uitvoeren als je hem daar tools voor geeft.

Is HubSpot gekoppeld via de native integratie van Retell, dan kan de agent tijdens het praten tools gebruiken zoals Search Contact, List Contact Deals, Update Deal, Update Contact en Create Task. Hij kan een e-mailadres corrigeren dat het contact net heeft doorgegeven, of de vervolgtaak aanmaken waarmee het contact heeft ingestemd. Voor een CRM zonder native integratie doet een custom function hetzelfde door tijdens het gesprek je eigen API aan te roepen.

Houd rekening met twee situaties. Als een CRM-toolaanroep mislukt of een time-out krijgt, loopt het gesprek gewoon door. De prompt moet de agent dus vertellen wat hij moet zeggen als een opzoeking niets oplevert. En als een uitgaand gesprek bij de voicemail uitkomt in plaats van bij een persoon, kan de agent ophangen of een bericht achterlaten, afhankelijk van je configuratie, en krijgt het gesprek de markering in_voicemail. Die markering is belangrijk bij het terugschrijven.

Hoe komen gespreksresultaten terug in het CRM-record?

Na afloop van het gesprek voert Retell een analyse na het gesprek uit op de transcriptie (in het product heet dit Post Call Extraction). De resultaten komen vervolgens via een van drie routes in het CRM terecht, afhankelijk van wat je CRM ondersteunt en wie de koppelingslogica beheert.

Wat er wordt gegenereerd. Elk gesprek krijgt call_summary, user_sentiment, call_successful en in_voicemail. Je voegt eigen velden toe voor je eigen uitkomsten, elk van het type boolean, tekst, getal of selector: qualified, budget_range, callback_requested. Het gespreksrecord bevat ook de volledige transcriptie en een opname-URL. Zie analyse na het gesprek voor hoe velden worden gedefinieerd.

Route 1: de HubSpot Marketplace-app. Zodra het gesprek is afgerond, schrijft de app de samenvatting en analyse naar de activiteitentijdlijn van het contact, zet de opname en transcriptie in het gesprekslog en toont het log op de tijdlijn van het gekoppelde bedrijf. De gepauzeerde workflow gaat daarna verder en kan vertakken op outputs zoals Call Success, User Sentiment of Call Outcome: een opvolgmail bij succes, een nieuwe poging of een SMS als er niet wordt opgenomen.

Route 2: native CRM-integratie. De integraties van Retell met HubSpot, Salesforce, Microsoft Dynamics 365, GoHighLevel en Zoho CRM koppelen velden uit de analyse na het gesprek aan contactvelden en sturen ze door naar het CRM-record. Elke koppeling heeft een updatemodus: Overwrite voor statusvelden, Fill only if empty voor vaste gegevens zoals e-mail, of Accumulate & summarize om notities van meerdere gesprekken samen te voegen. Zet Log activities automatically aan en elk gesprek wordt ook op het contact gelogd, bijvoorbeeld als Call-engagement in HubSpot of als Task in Salesforce. Functies na het gesprek voegen daar gerichte schrijfacties aan toe, zoals een HubSpot Create Task die alleen draait als een veld followup_needed true is.

Eén kanttekening bij route 2: die schrijft alleen naar contacten die zijn geïmporteerd uit de actieve CRM-koppeling. Een nummer dat niet overeenkomt met een gesynchroniseerd contact levert geen activiteitenrecord op, en Retell werkt bestaande CRM-records bij in plaats van nieuwe aan te maken, tenzij je Create new contacts in CRM aanzet.

Route 3: een webhook naar je CRM. Retell stuurt een call_analyzed-event naar je endpoint met het volledige call-object: transcriptie, opname-URL, analyseresultaten en de metadata die je bij de trigger hebt meegestuurd. Je service leest de record-ID uit metadata en schrijft via de API van het CRM. Controleer de header x-retell-signature en stuur binnen 10 seconden een 2xx terug, anders probeert Retell het tot 3 keer opnieuw. Ontdubbel op call_id, zodat een nieuwe poging hetzelfde gesprek nooit twee keer wegschrijft. Luister naar call_analyzed, niet naar call_ended: de call_ended-payload wordt verstuurd voordat de analyse draait en bevat dus geen analyseresultaten.

Hoe ziet de volledige koppeling van trigger tot terugschrijven eruit?

De tabel koppelt veelvoorkomende HubSpot-triggers aan wat de agent doet en wat er terugkomt op het record. De webhookroute volgt dezelfde drie kolommen.

Eigen analysevelden worden niet ingevuld voor gesprekken die nooit tot stand zijn gekomen. Bouw de tak voor niet-opgenomen gesprekken daarom op de ingebouwde velden en de gespreksuitkomst, niet op je eigen velden.

Wat moet je controleren voordat je live gaat?

• Elk ingeschreven contact heeft een geldig E.164-telefoonnummer, en de workflow filtert de rest eruit.
• De CRM-inloggegevens hebben schrijfrechten op elk object waarnaar je terugschrijft. In HubSpot geeft een ontbrekende scope geen foutmelding op de koppeling; de betreffende schrijfactie werkt gewoon niet meer.
• Elk eigen analyseveld heeft een specifieke beschrijving waarop de LLM kan extraheren, en er bestaat een bijbehorende CRM-eigenschap.
• Schrijfacties na het gesprek zijn afgeschermd, zodat een gesprek dat nooit tot stand kwam niets misleidends wegschrijft.
• Eén systeem is verantwoordelijk voor de tijdlijnvermelding. De Marketplace-app en de native integratie zijn onafhankelijk en kunnen naast elkaar draaien, dus bepaal welke van de twee het gesprek logt.
• Het belverbod wordt gehandhaafd waar je dat verwacht. Het contactveld do_not_call van Retell blokkeert op zichzelf geen gesprekken; geef honor_internal_dnc: true mee bij API-aanroepen zodat Retell ze weigert, en houd de eigen uitsluitingsregels van je CRM in de trigger.
• Je test met een sandboxrecord. Een tool die records aanmaakt of bijwerkt testen, schrijft een echt record weg.

Waar begin je?

Is HubSpot je leidende systeem, dan dekt de HubSpot-integratie van Retell beide helften van deze cyclus: de native koppeling die de agent context geeft en resultaten terugschrijft, en de Marketplace-app waarmee een HubSpot-workflow het gesprek start. Volg voor de stapsgewijze configuratie, inclusief de scopes van de private app, de HubSpot-installatiegids. Werk je met Salesforce, Dynamics 365, Zoho of iets anders? Begin bij het overzicht van integraties en gebruik de webhookroute voor elk CRM dat er niet tussen staat.

Verder lezen: De checklist voor uitgaande telefoonnummers, de scope van een eerste partnerdeal bepalen en meer gidsen in de Retell Learn-hub.