CRM-till-röst-AI-arbetsflödet, förklarat utan jargong

Att koppla ett CRM till en AI-röstagent handlar om fyra överlämningar. CRM:et bestämmer vem som ska ringas. Samtalsförfrågan innehåller det agenten behöver veta. Agenten för samtalet. Resultaten hamnar tillbaka på samma CRM-post. Den mesta förvirringen kring integrationer beror på att de fyra blandas ihop, eller på att man inte vet vilket system som äger vart och ett av dem.

Den här guiden går igenom förloppet med ett HubSpot-arbetsflöde som exempel och visar sedan samma loop för alla CRM-system som kan skicka en webhook.

Vilka är de fyra stegen i ett arbetsflöde från CRM till röst-AI?

Utlösare, kontext, samtal och återskrivning:

1. Utlösare. En CRM-händelse (ett ifyllt formulär, en ändrad affärsfas, ett datum som infaller) startar ett arbetsflöde som ber röstplattformen att ringa ett samtal.
2. Kontext. Samtalsförfrågan innehåller data från CRM-posten, så agenten börjar samtalet med kontaktens namn och situation redan kända.
3. Samtal. Agenten pratar och kan läsa eller uppdatera CRM-poster medan samtalet pågår.
4. Återskrivning. Efter samtalet bifogas en sammanfattning, strukturerade utfallsfält, transkriptionen och inspelningen till CRM-posten, och CRM-arbetsflödet avgör vad som händer härnäst.

Vad är det egentligen som startar AI-samtalet från CRM:et?

Ett CRM-arbetsflöde startar samtalet på ett av två sätt: med en inbyggd arbetsflödesåtgärd eller med en webhook som din egen tjänst omvandlar till ett API-anrop.

Inbyggd åtgärd (HubSpot). Retell AI-appen på HubSpot Marketplace lägger till åtgärden Make a Phone Call i HubSpot-arbetsflöden. Utgå från en utlösare du redan använder: en formulärinskickning, en ny post, en ändrad affärsfas eller en datumegenskap som ett mötesdatum. Lägg till villkoret "Phone number is known" så att kontakter utan nummer aldrig registreras. Fyll sedan i tre fält i åtgärden: From (Retell-agenten och telefonnumret), To (kontaktens telefontoken) och, om du vill, Dynamic Variables som JSON. Arbetsflödet pausas tills samtalet är klart.

Webhook plus API (valfritt CRM). Om ditt CRM kan skicka en webhook från ett arbetsflöde pekar du den mot en liten tjänst som du äger. Den tjänsten anropar Create Phone Call API från Retell med fyra saker: from_number, to_number, kontextfälten i retell_llm_dynamic_variables och CRM-postens ID i metadata. Retell lagrar metadata med samtalet och returnerar det i samtalsobjektet i senare webhooks, och det är så resultatet hittar tillbaka till rätt post.

Listor i stället för händelser. För en kampanj mot ett segment snarare än en enskild händelse exporterar du listan och kör den som ett batchsamtal: en CSV med en kolumn för telefonnummer, där varje extra kolumn blir en variabel som agenten kan använda.

Två förutsättningar gäller för alla vägar. Numret som ringer behöver ha en utgående agent kopplad till sig, och numren du ringer måste vara giltiga E.164-nummer (till exempel +14155550123).

Hur vet agenten vem den ringer?

Genom dynamiska variabler: namngivna värden som {{first_name}} eller {{deal_stage}} som Retell fyller i innan agenten börjar tala. De kommer från tre ställen:

• Samtalsförfrågan. Det som JSON-koden i HubSpot-åtgärden eller ditt API-anrop skickar i retell_llm_dynamic_variables.
• Synkade kontaktfält. Om du använder den inbyggda CRM-kontaktsynkningen i Retell får ett samtal vars nummer matchar en synkad kontakt automatiskt kontaktens mappade fält som variabler.
• En uppslagning före samtalet. En funktion före samtalet på agentens Workflow-sida kan söka efter numret i CRM:et och mappa fält från svaret till variabler. Vid utgående samtal körs den innan Retell ringer, så kontakten hör aldrig uppslagningen.

När samma namn kommer från mer än en källa vinner värdet i förfrågan över det synkade kontaktfältet, och allt som agenten samlar in under samtalet vinner över båda.

Tre regler förhindrar de flesta fall där en agent läser upp en platshållare högt:

• Skicka varje värde som en sträng, alltså "42" och "true", inte 42 och true.
• Platta till objekt. {{client.name}} löses inte upp; skicka client_name i stället.
• Ange standardvärden på agentnivå. En variabel utan värde står kvar i sin råa {{braces}}-form i prompten.

Vad händer under samtalet?

Agenten för samtalet utifrån sin prompt och sina variabler och kan agera i CRM:et mitt i samtalet om du ger den verktyg.

När HubSpot är anslutet via den inbyggda integrationen i Retell kan agenten använda verktyg som Search Contact, List Contact Deals, Update Deal, Update Contact och Create Task medan den pratar. Den kan rätta en e-postadress som kontakten just har uppgett, eller skapa den uppföljningsuppgift som kontakten har gått med på. För ett CRM utan inbyggd integration gör en anpassad funktion samma jobb genom att anropa ditt eget API mitt i samtalet.

Planera för två beteenden. Om ett anrop till ett CRM-verktyg misslyckas eller överskrider tidsgränsen fortsätter samtalet, så prompten bör tala om för agenten vad den ska säga när en uppslagning inte ger något resultat. Och när ett utgående samtal hamnar i röstbrevlådan i stället för hos en person kan agenten lägga på eller lämna ett meddelande, beroende på hur du konfigurerar den, och samtalet flaggas med in_voicemail. Den flaggan spelar roll vid återskrivningen.

Hur kommer samtalsresultaten tillbaka till CRM-posten?

När samtalet har avslutats kör Retell en analys efter samtal på transkriptionen (i produkten kallas det Post Call Extraction). Resultaten når sedan CRM:et via en av tre vägar, beroende på vad ditt CRM stöder och vem som ska äga mappningslogiken.

Vad som produceras. Varje samtal får call_summary, user_sentiment, call_successful och in_voicemail. Du lägger till anpassade fält för dina egna utfall, vart och ett av typen boolean, text, nummer eller väljare: qualified, budget_range, callback_requested. Samtalsposten innehåller också hela transkriptionen och en inspelnings-URL. Se analys efter samtal för hur fält definieras.

Väg 1: HubSpot Marketplace-appen. När samtalet är klart skriver appen sammanfattningen och analysen till kontaktens aktivitetstidslinje, lägger inspelningen och transkriptionen i samtalsloggen och visar loggen på det kopplade företagets tidslinje. Det pausade arbetsflödet återupptas sedan och kan förgrena sig utifrån utdata som Call Success, User Sentiment eller Call Outcome: ett uppföljningsmejl vid lyckat samtal, ett nytt försök eller ett SMS när ingen svarar.

Väg 2: inbyggd CRM-integration. Integrationerna i Retell med HubSpot, Salesforce, Microsoft Dynamics 365, GoHighLevel och Zoho CRM mappar fält från analysen efter samtal till kontaktfält och skickar dem till CRM-posten. Varje mappning har ett uppdateringsläge: Overwrite för statusfält, Fill only if empty för stabila uppgifter som e-post, eller Accumulate & summarize för att slå samman anteckningar från flera samtal. Aktivera Log activities automatically så loggas varje samtal även på kontakten, till exempel som ett Call engagement i HubSpot eller en Task i Salesforce. Funktioner efter samtal lägger till riktade skrivningar ovanpå, till exempel en HubSpot Create Task som bara körs när fältet followup_needed är true.

En hake med väg 2: den skriver bara till kontakter som har importerats från den aktiva CRM-anslutningen. Ett nummer som inte matchar en synkad kontakt ger ingen aktivitetspost, och Retell uppdaterar befintliga CRM-poster i stället för att skapa nya, om du inte aktiverar Create new contacts in CRM.

Väg 3: en webhook till ditt CRM. Retell skickar en call_analyzed-händelse till din endpoint med hela samtalsobjektet: transkription, inspelnings-URL, analysresultat och den metadata du skickade vid utlösningen. Din tjänst läser post-ID:t från metadata och skriver till CRM:ets API. Verifiera headern x-retell-signature och returnera en 2xx inom 10 sekunder, eftersom Retell annars gör upp till 3 nya försök. Deduplicera på call_id så att ett nytt försök aldrig skriver samma samtal två gånger. Lyssna efter call_analyzed, inte call_ended: call_ended-payloaden skickas innan analysen körs, så den innehåller inga analysresultat.

Hur ser hela kopplingen från utlösare till återskrivning ut?

Tabellen kopplar vanliga HubSpot-utlösare till vad agenten gör och vad som hamnar tillbaka på posten. Webhook-vägen följer samma tre kolumner.

Anpassade analysfält fylls inte i för samtal som aldrig kopplades fram, så bygg grenen för obesvarade samtal på de inbyggda fälten och samtalsutfallet, inte på dina anpassade fält.

Vad bör du kontrollera innan du går live?

• Varje registrerad kontakt har ett giltigt telefonnummer i E.164-format, och arbetsflödet filtrerar bort resten.
• CRM-autentiseringsuppgifterna har skrivbehörighet till varje objekt du skriver tillbaka till. I HubSpot flaggas inte anslutningen om ett scope saknas; den berörda skrivningen slutar bara att fungera.
• Varje anpassat analysfält har en specifik beskrivning som LLM:en kan extrahera utifrån, och det finns en motsvarande CRM-egenskap.
• Skrivningar efter samtal är villkorade, så att ett samtal som aldrig kopplades fram inte skriver något missvisande.
• Ett enda system äger posten på tidslinjen. Marketplace-appen och den inbyggda integrationen är oberoende av varandra och kan köras samtidigt, så bestäm vilken av dem som loggar samtalet.
• Spärrlistan (do-not-call) tillämpas där du förväntar dig. Kontaktfältet do_not_call i Retell blockerar inte samtal på egen hand; skicka honor_internal_dnc: true i API-anrop för att låta Retell avvisa dem, och behåll ditt CRM:s egna spärrregler i utlösaren.
• Du testar mot en sandlådepost. Att testa ett verktyg som skapar eller uppdaterar poster skriver en riktig post.

Var du ska börja

Om HubSpot är ditt primära system täcker Retell HubSpot-integrationen båda halvorna av den här loopen: den inbyggda anslutningen som ger agenten kontext och skriver tillbaka resultat, och Marketplace-appen som låter ett HubSpot-arbetsflöde ringa samtalet. För konfigurationen steg för steg, inklusive scopes för den privata appen, följer du guiden för HubSpot-konfiguration. Använder du Salesforce, Dynamics 365, Zoho eller något annat? Börja i integrationskatalogen och använd webhook-vägen för alla CRM-system som inte finns med i listan.

Läs mer: Checklistan för utgående telefonnummer, att avgränsa en första partneraffär och fler guider i Retell Learn-hubben.