Workflowet fra CRM til stemme-AI forklaret uden jargon

At forbinde et CRM med en AI-stemmeagent handler om fire overdragelser. CRM'et bestemmer, hvem der skal ringes op. Opkaldsanmodningen indeholder det, agenten har brug for at vide. Agenten fører samtalen. Resultaterne lander tilbage på den samme CRM-post. Det meste forvirring om integrationer skyldes, at de fire trin bliver blandet sammen, eller at man ikke ved, hvilket system der ejer hvert enkelt trin.

Denne guide gennemgår forløbet med et HubSpot-workflow som eksempel og viser derefter det samme kredsløb for ethvert CRM, der kan sende en webhook.

Hvad er de fire trin i et workflow fra CRM til stemme-AI?

Trigger, kontekst, samtale og tilbageskrivning:

1. Trigger. En hændelse i CRM'et (en udfyldt formular, en ændret deal-fase, en dato, der nås) starter et workflow, der beder stemmeplatformen om at foretage et opkald.
2. Kontekst. Opkaldsanmodningen indeholder data fra CRM-posten, så agenten starter opkaldet og allerede kender kontaktens navn og situation.
3. Samtale. Agenten taler og kan læse eller opdatere CRM-poster undervejs.
4. Tilbageskrivning. Efter opkaldet knyttes en opsummering, strukturerede resultatfelter, transskriptionen og optagelsen til CRM-posten, og CRM-workflowet bestemmer, hvad der sker derefter.

Hvad udløser egentlig AI-opkaldet fra CRM'et?

Et CRM-workflow udløser opkaldet på en af to måder: via en indbygget workflow-handling eller via en webhook, som din egen tjeneste omsætter til et API-kald.

Indbygget handling (HubSpot). Retell AI-appen i HubSpot Marketplace tilføjer handlingen Make a Phone Call til HubSpot-workflows. Start fra en trigger, du allerede bruger: en formularindsendelse, en ny post, en ændret deal-fase eller en datoegenskab som fx en aftaledato. Tilføj betingelsen "Phone number is known", så kontakter uden et nummer aldrig tilmeldes. Udfyld derefter tre felter i handlingen: From (Retell-agenten og telefonnummeret), To (kontaktens telefon-token) og eventuelt Dynamic Variables som JSON. Workflowet sættes på pause, indtil opkaldet er afsluttet.

Webhook plus API (ethvert CRM). Hvis dit CRM kan sende en webhook fra et workflow, så peg den mod en lille tjeneste, du selv ejer. Tjenesten kalder Create Phone Call API'et fra Retell med fire ting: from_number, to_number, kontekstfelterne i retell_llm_dynamic_variables og CRM-postens ID i metadata. Retell gemmer metadata sammen med opkaldet og returnerer det i opkaldsobjektet i senere webhooks, og det er sådan, resultatet finder tilbage til den rigtige post.

Lister i stedet for hændelser. Til en kampagne mod et segment frem for en enkelt hændelse eksporterer du listen og kører den som et batchopkald: en CSV med en kolonne til telefonnumre, hvor hver ekstra kolonne bliver en variabel, agenten kan bruge.

To forudsætninger gælder for alle veje. Det nummer, der ringes fra, skal have en udgående agent tilknyttet, og de numre, du ringer til, skal være gyldige E.164-numre (for eksempel +14155550123).

Hvordan ved agenten, hvem den ringer til?

Via dynamiske variabler: navngivne værdier som {{first_name}} eller {{deal_stage}}, som Retell udfylder, før agenten taler. De kommer fra tre steder:

• Opkaldsanmodningen. Det, som HubSpot-handlingens JSON eller dit API-kald sender i retell_llm_dynamic_variables.
• Synkroniserede kontaktfelter. Hvis du bruger den indbyggede CRM-kontaktsynkronisering i Retell, får et opkald, hvis nummer matcher en synkroniseret kontakt, automatisk kontaktens tilknyttede felter som variabler.
• Et opslag før opkaldet. En pre-call-funktion på agentens Workflow-side kan søge efter nummeret i CRM'et og tilknytte felter fra svaret til variabler. Ved udgående opkald kører den, før Retell ringer op, så kontakten aldrig hører opslaget.

Når det samme navn kommer fra mere end én kilde, vinder værdien fra anmodningen over det synkroniserede kontaktfelt, og alt, hvad agenten indsamler under opkaldet, vinder over begge.

Tre regler forhindrer de fleste tilfælde, hvor en agent læser en pladsholder højt:

• Send alle værdier som strenge, altså "42" og "true", ikke 42 og true.
• Gør objekter flade. {{client.name}} bliver ikke udfyldt; send client_name i stedet.
• Angiv standardværdier på agentniveau. En variabel uden værdi forbliver i sin rå {{braces}}-form i prompten.

Hvad sker der under opkaldet?

Agenten fører samtalen ud fra sin prompt og sine variabler og kan handle i CRM'et midt i opkaldet, hvis du giver den værktøjer.

Når HubSpot er forbundet via den indbyggede integration i Retell, kan agenten bruge værktøjer som Search Contact, List Contact Deals, Update Deal, Update Contact og Create Task, mens den taler. Den kan rette en e-mailadresse, som kontakten lige har oplyst, eller oprette den opfølgningsopgave, kontakten har sagt ja til. For et CRM uden indbygget integration klarer en tilpasset funktion samme opgave ved at kalde dit eget API midt i opkaldet.

Planlæg efter to former for adfærd. Hvis et kald til et CRM-værktøj fejler eller får timeout, fortsætter samtalen, så prompten bør fortælle agenten, hvad den skal sige, når et opslag ikke giver noget resultat. Og når et udgående opkald rammer en telefonsvarer i stedet for en person, kan agenten lægge på eller lægge en besked, afhængigt af hvordan du konfigurerer den, og opkaldet markeres med in_voicemail. Den markering har betydning ved tilbageskrivningen.

Hvordan kommer opkaldsresultaterne tilbage i CRM-posten?

Når opkaldet er slut, kører Retell analyse efter opkald på transskriptionen (i produktet hedder det Post Call Extraction). Resultaterne når derefter CRM'et ad en af tre veje, afhængigt af hvad dit CRM understøtter, og hvem der skal eje mapping-logikken.

Hvad der bliver produceret. Hvert opkald får call_summary, user_sentiment, call_successful og in_voicemail. Du tilføjer tilpassede felter til dine egne resultater, hver med typen boolean, tekst, tal eller selector: qualified, budget_range, callback_requested. Opkaldsposten indeholder også den fulde transskription og en URL til optagelsen. Se analyse efter opkald for, hvordan felter defineres.

Vej 1: HubSpot Marketplace-appen. Når opkaldet er afsluttet, skriver appen opsummeringen og analysen til kontaktens aktivitetstidslinje, lægger optagelsen og transskriptionen i opkaldsloggen og viser loggen på den tilknyttede virksomheds tidslinje. Det pausede workflow genoptages derefter og kan forgrene sig på output som Call Success, User Sentiment eller Call Outcome: en opfølgningsmail ved succes, et nyt forsøg eller en SMS, hvis ingen svarer.

Vej 2: indbygget CRM-integration. Retell-integrationerne med HubSpot, Salesforce, Microsoft Dynamics 365, GoHighLevel og Zoho CRM tilknytter felter fra analysen efter opkald til kontaktfelter og sender dem til CRM-posten. Hver tilknytning har en opdateringstilstand: Overwrite til statusfelter, Fill only if empty til stabile fakta som e-mail eller Accumulate & summarize til at samle noter på tværs af opkald. Slå Log activities automatically til, så logges hvert opkald også på kontakten, for eksempel som et Call engagement i HubSpot eller en Task i Salesforce. Post-call-funktioner tilføjer målrettede skrivninger oveni, såsom en HubSpot Create Task, der kun kører, når feltet followup_needed er true.

Én hage ved Vej 2: Den skriver kun til kontakter, der er importeret fra den aktive CRM-forbindelse. Et nummer, der ikke matcher en synkroniseret kontakt, giver ingen aktivitetspost, og Retell opdaterer eksisterende CRM-poster i stedet for at oprette nye, medmindre du slår Create new contacts in CRM til.

Vej 3: en webhook ind i dit CRM. Retell sender en call_analyzed-hændelse til dit endpoint med hele opkaldsobjektet: transskription, URL til optagelsen, analyseresultater og de metadata, du sendte ved triggeren. Din tjeneste læser post-ID'et fra metadata og skriver til CRM'ets API. Verificér headeren x-retell-signature, og returnér en 2xx inden for 10 sekunder, ellers forsøger Retell igen op til 3 gange. Dedupliker på call_id, så et nyt forsøg aldrig skriver det samme opkald to gange. Lyt efter call_analyzed, ikke call_ended: call_ended-payloaden sendes, før analysen kører, så den indeholder ingen analyseresultater.

Hvordan ser den fulde tilknytning fra trigger til tilbageskrivning ud?

Tabellen viser almindelige HubSpot-triggere, hvad agenten gør, og hvad der lander tilbage på posten. Webhook-vejen følger de samme tre kolonner.

Tilpassede analysefelter udfyldes ikke for opkald, der aldrig blev forbundet, så byg grenen for ubesvarede opkald på de indbyggede felter og opkaldsresultatet, ikke på dine tilpassede felter.

Hvad skal du tjekke, før du går live?

• Alle tilmeldte kontakter har et gyldigt E.164-telefonnummer, og workflowet filtrerer resten fra.
• CRM-legitimationsoplysningerne har skriveadgang til alle de objekter, du skriver tilbage til. I HubSpot bliver forbindelsen ikke markeret, hvis et scope mangler; den berørte skrivning holder bare op med at virke.
• Hvert tilpasset analysefelt har en specifik beskrivelse, som LLM'en kan udtrække ud fra, og der findes en matchende CRM-egenskab.
• Skrivninger efter opkald er betingede, så et opkald, der aldrig blev forbundet, ikke skriver noget misvisende.
• Ét system ejer tidslinjeposten. Marketplace-appen og den indbyggede integration er uafhængige og kan køre samtidig, så beslut, hvilken af dem der logger opkaldet.
• Do-not-call håndhæves dér, hvor du forventer det. Kontaktfeltet do_not_call i Retell blokerer ikke opkald i sig selv; send honor_internal_dnc: true med i API-kald for at få Retell til at afvise dem, og behold dit CRM's egne spærreregler i triggeren.
• Du tester mod en sandbox-post. Når du tester et værktøj til at oprette eller opdatere, skrives der en rigtig post.

Hvor du skal starte

Hvis HubSpot er dit primære system, dækker Retell HubSpot-integrationen begge halvdele af dette kredsløb: den indbyggede forbindelse, der giver agenten kontekst og skriver resultater tilbage, og Marketplace-appen, der lader et HubSpot-workflow foretage opkaldet. Følg opsætningsguiden til HubSpot for at få opsætningen klik for klik, inklusive scopes til den private app. Bruger du Salesforce, Dynamics 365, Zoho eller noget helt andet? Start i integrationsoversigten, og brug webhook-vejen til ethvert CRM, der ikke er på listen.

Relateret læsning: Tjeklisten til udgående telefonnumre, afgrænsning af din første partneraftale og flere guides i Retell Learn-hubben.