EspoCRM | ElevenLabs Documentation

Med webhook-verktygen nedan kan din receptionist identifiera uppringare som redan finns i EspoCRM och lägga till nya uppringare som leads, med deras namn, telefonnummer och vad de behöver, så att ditt team kan följa upp. EspoCRM:s API använder en statisk API-nyckel och JSON-begärandetexter, så det fungerar på samma sätt för EspoCRM Cloud och självhostade installationer.

Innan du börjar

Skapa en roll

Gå till Administration → Roles i EspoCRM och skapa en roll som kan läsa och skapa Leads samt läsa Contacts. Låt alla andra områden vara inaktiverade.

Skapa en API-användare

Gå till Administration → API Users och skapa en användare. Ställ in autentiseringsmetoden på API Key och tilldela rollen du nyss skapade. Spara och kopiera sedan API-nyckeln från användarens detaljvy.

Varje verktyg nedan skickar nyckeln i en begärandehuvudrad med namnet X-Api-Key. Ställ in dess Type på Secret.

API-nyckeln kan läsa och ändra allt som rollen tillåter. Begränsa rollens behörigheter och skapa om nyckeln i EspoCRM om den läcker.

Hitta din EspoCRM-adress

Dina verktygs URL:er börjar med adressen du öppnar i webbläsaren för att använda EspoCRM, följt av /api/v1/. Tabellerna nedan använder https://YOUR-CRM.example.com; ersätt den med din egen.

Skapa verktygen

För varje verktyg går du till Integrations, väljer Add integration, väljer Webhook Tool och ställer in Assign to agents på Receptionist. Ställ in Value på Fixed value för varje parameter som nedan är markerad med “Always”.

Hitta ett lead

Fält	Värde
Namn	`find_espocrm_lead`
Beskrivning	”Hitta uppringaren bland våra leads via telefonnummer. Använd det i början av ett samtal för att kontrollera om personen har kontaktat oss tidigare.”
Metod	GET
URL	`https://YOUR-CRM.example.com/api/v1/Lead`
Begärandehuvudrader	`X-Api-Key`: din API-nyckel
Frågeparametrar	`textFilter` (sträng, krävs): “Uppringarens telefonnummer med landskod, till exempel +14155550123.” `select` (sträng): Always `id,name,status`. `maxSize` (heltal): Always `5`.

För att även identifiera befintliga kunder skapar du ett andra verktyg med namnet find_espocrm_contact, med samma inställningar och URL:en https://YOUR-CRM.example.com/api/v1/Contact.

Lägg till ett nytt lead

Fält	Värde
Namn	`create_espocrm_lead`
Beskrivning	”Lägg till uppringaren som ett nytt lead när `find_espocrm_lead` inte hittade personen.”
Metod	POST
URL	`https://YOUR-CRM.example.com/api/v1/Lead`
Begärandehuvudrader	`X-Api-Key`: din API-nyckel
Brödtextparametrar	`firstName` (sträng, krävs): “Uppringarens förnamn.” `lastName` (sträng, krävs): “Uppringarens efternamn.” `phoneNumber` (sträng, krävs): “Uppringarens telefonnummer i internationellt format, till exempel +14155550123.” `emailAddress` (sträng): “Uppringarens e-postadress, om personen uppgav en.” `description` (sträng, krävs): “Vad uppringaren behöver och när personen vill bli uppringd.” `status` (sträng): Always `New`. `source` (sträng): Always `Call`.

För att tilldela nya leads till en viss säljare lägger du till assignedUserId (sträng) som ett fast värde med användarens ID. Du ser ID:t i adressfältet när du öppnar användaren i EspoCRM.

Välj Enable för varje verktyg och testa sedan din receptionist som en ny uppringare som ber om en offert. Leadet visas i EspoCRM med statusen New och källan Call.

Lägg till en procedur så att din receptionist söker först och bara lägger till ett lead när ingen träff hittas.

Sökningen matchar även namn och e-postadresser, så en uppringare kan försöka söka efter någon annan. Lägg till en regel om att din receptionist aldrig läser upp CRM-poster för uppringare, och begränsa select till id,name,status.

Begränsningar

textFilter är samma sökning som EspoCRM:s eget sökfält: den söker i namn, e-postadresser och telefonnummer. En sökning på telefonnummer kan också matcha en annan post vars nummer börjar med samma siffror, så din receptionist bör bekräfta uppringarens namn.
Din receptionist kan inte lägga till en anteckning eller uppgift till ett befintligt lead eller en befintlig kontakt med dessa verktyg. Det nya leadets beskrivning innehåller samtalsuppgifterna.
Verktygen ställer inte in team. EspoCRM hanterar team som en lista med team-ID:n (teamsIds), och ett webhook-verktyg fyller alltid en lista från konversationen, så det kan inte placera varje lead i samma team och din receptionist bör inte välja team. Använd i stället assignedUserId för att tilldela leads.

Felsökning

Problem	Vad du ska kontrollera
401 från EspoCRM	Huvudraden måste heta `X-Api-Key` och innehålla nyckeln från API-användarens detaljvy. Kontrollera att API-användaren är aktiv.
403 från EspoCRM	API-användarens roll kan inte läsa eller skapa leads. Redigera rollen i Administration → Roles.
409 när ett lead läggs till	EspoCRM hittade en möjlig dubblett, till exempel ett lead med samma namn eller e-postadress. Din receptionist bör söka först.
Kända uppringare hittas inte	Spara telefonnummer i internationellt format, till exempel `+14155550123`, och kontrollera att numret finns på ett lead eller en kontakt, inte bara på ett konto.
Fel för `status` eller `source`	Värdena måste exakt matcha dina alternativ för leadets Status och Source, enligt inställningarna i Administration → Entity Manager → Lead.