> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # EspoCRM Med [webhook-verktygen](/docs/sv/reception-ai/integrations/webhooks) 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**. > **Warning** > > 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](/docs/sv/reception-ai/receptionist/testing) som en ny uppringare som ber om en offert. Leadet visas i EspoCRM med statusen **New** och källan **Call**. > **Tip** > > Lägg till en [procedur](/docs/sv/reception-ai/receptionist/rules-and-procedures) så att din receptionist > söker först och bara lägger till ett lead när ingen träff hittas. > **Warning** > > 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**. |