> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # ERPNext Med [webhook-verktygen](/docs/sv/reception-ai/integrations/webhooks) nedan kan din receptionist känna igen uppringare som redan är leads i ERPNext, registrera nya uppringare som leads med deras namn, telefonnummer och en anteckning om vad de behöver, samt lämna en kommentar på befintliga leads så att ditt säljteam kan ringa upp dem. ERPNext och Frappe-ramverket accepterar en statisk API-nyckel och hemlighet samt JSON-begärandetexter, så detta fungerar på Frappe Cloud och självhostade webbplatser. ## Innan du börjar ### Skapa en API-användare I ERPNext skapar du en användare för Reception.ai, till exempel `reception@yourcompany.com`, och ger den endast rollen **Sales User**. API-begäranden körs med den här användarens behörigheter, så använd inte en administratör. ### Generera nycklarna Öppna användaren, välj fliken **Settings**, expandera **API Access** och välj **Generate Keys**. Kopiera **API Secret** från popupfönstret direkt: ERPNext visar den bara en gång. **API Key** förblir synlig i samma avsnitt. Varje verktyg nedan skickar en begärandehuvudrad med namnet `Authorization` och värdet `token API_KEY:API_SECRET`, där din nyckel och hemlighet separeras med ett kolon. Ange dess **Type** som **Secret**. > **Warning** > > Nyckeln och hemligheten kan läsa och ändra allt som rollen **Sales User** tillåter. Håll dem borta från > delade dokument och välj **Generate Keys** igen för att ersätta dem om de läcker. ### Hitta din webbplatsadress Dina verktygs URL:er börjar med adressen du öppnar i webbläsaren för att använda ERPNext. Tabellerna nedan använder `https://YOUR-SITE.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 är märkt med "Always" nedan. ### Hitta ett lead | Fält | Värde | | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Namn** | `find_erpnext_lead` | | **Beskrivning** | "Hitta uppringaren bland våra leads efter 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-SITE.example.com/api/resource/Lead` | | **Begärandehuvudrader** | `Authorization`: `token API_KEY:API_SECRET` | | **Frågeparametrar** | `or_filters` (sträng, obligatorisk): "Ett filter på de sista sju siffrorna i uppringarens nummer, precis som `[["mobile_no","like","%5550123%"],["phone","like","%5550123%"]]`." `fields` (sträng): Always `["name","lead_name","status"]`. `limit_page_length` (heltal): Always `5`. | ### Registrera ett nytt lead | Fält | Värde | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Namn** | `create_erpnext_lead` | | **Beskrivning** | "Registrera uppringaren som ett nytt lead när `find_erpnext_lead` inte hittade personen." | | **Metod** | POST | | **URL** | `https://YOUR-SITE.example.com/api/resource/Lead` | | **Begärandehuvudrader** | `Authorization`: `token API_KEY:API_SECRET` | | **Body-parametrar** | `first_name` (sträng, obligatorisk): "Uppringarens förnamn." `last_name` (sträng): "Uppringarens efternamn." `mobile_no` (sträng, obligatorisk): "Uppringarens telefonnummer i internationellt format, till exempel +14155550123." `email_id` (sträng): "Uppringarens e-postadress, om personen uppgav en." `lead_owner` (sträng): Always e-postadressen till säljaren som ringer tillbaka till nya leads. `notes` (array): se nedan. | För att ange var leads kommer från lägger du till `source` (sträng) som ett fast värde som exakt matchar en av dina **Lead Source**-poster. I ERPNext 16 och senare heter fältet i stället `utm_source`, och det måste matcha en **UTM Source**-post. `notes` fyller i leadets flik **Notes**. Ge det beskrivningen "Skicka exakt ett objekt med vad uppringaren behöver." Under **Each item** väljer du `object` och sedan **Add field** för vart och ett av dessa: * `note` (sträng, obligatorisk): "Vad uppringaren behöver och när personen vill bli uppringd." * `added_by` (sträng): Always API-användarens e-postadress. ### Logga samtalsinformationen | Fält | Värde | | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Namn** | `add_erpnext_lead_comment` | | **Beskrivning** | "Lämna en kommentar på uppringarens lead med vad personen behöver. Använd det när `find_erpnext_lead` hittade uppringaren, med leadets namn, till exempel CRM-LEAD-2026-00012." | | **Metod** | POST | | **URL** | `https://YOUR-SITE.example.com/api/method/frappe.desk.form.utils.add_comment` | | **Begärandehuvudrader** | `Authorization`: `token API_KEY:API_SECRET` | | **Body-parametrar** | `reference_doctype` (sträng): Always `Lead`. `reference_name` (sträng, obligatorisk): "Leadets namn, från `find_erpnext_lead` eller `create_erpnext_lead`." `content` (sträng, obligatorisk): "Vad uppringaren behöver och när personen vill bli uppringd." `comment_email` (sträng): Always API-användarens e-postadress. `comment_by` (sträng): Always `Reception.ai`. | 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 att bli uppringd. Leadet visas i din **Lead**-lista, tilldelat din säljare, med din receptionists kommentar. > **Tip** > > Lägg till en [procedur](/docs/sv/reception-ai/receptionist/rules-and-procedures) för uppringare: hitta > leadet och registrera sedan antingen personen med en anteckning om den inte hittas, eller logga samtalsinformationen på det > lead som hittades. Lägg till en regel om att din receptionist aldrig läser upp leadposter för uppringare. > **Warning** > > Din receptionist skriver sökfiltret utifrån samtalet, så en uppringare kan försöka få den > att söka efter andra personers leads. Verktyget returnerar bara upp till fem namn och statusar, men behåll > regeln ovan. Om **Sales User** ger mer åtkomst än du vill, till exempel till kunder och > offerter, skapar du en anpassad roll som bara kan läsa, skapa och kommentera leads. ## Begränsningar * Sökningen letar efter de sista sju siffrorna i numret. Nummer som lagras med mellanslag eller bindestreck inom dessa siffror hittas inte, och två uppringare kan ha samma sista sju siffror. * Den här konfigurationen omfattar bara leads. Din receptionist söker inte efter kontakter eller kunder och skapar inte heller möjligheter. ## Felsökning | Problem | Kontrollera detta | | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 eller 403 från ERPNext | Huvudradsvärdet måste vara `token`, ett mellanslag och sedan nyckeln och hemligheten separerade med ett kolon. Kontrollera att användaren är aktiverad och har **Sales User**. | | Kända uppringare hittas inte | Spara nummer utan mellanslag eller bindestreck och kontrollera att numret finns i leadets fält **Mobile No** eller **Phone**. | | Fel om leadets ägare eller källa | `lead_owner` måste vara e-postadressen till en aktiverad användare och `source` måste exakt matcha en **Lead Source** (`utm_source` och en **UTM Source** i ERPNext 16 och senare). | | Fel om telefonnumret | ERPNext kontrollerar telefonnummer. Be din receptionist att bara skicka siffror med ett valfritt inledande `+`. | | Fel om `added_by` | `added_by` i `notes` måste vara e-postadressen till en aktiverad användare, till exempel API-användarens. | | Kommentaren läggs inte till | `reference_name` måste vara namnet på ett befintligt lead, till exempel `CRM-LEAD-2026-00012`. Kontrollera att verktyget för att hitta eller skapa kördes först. |