ERPNext | ElevenLabs Documentation

Med webhook-verktygen 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.

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 som en ny uppringare som ber om att bli uppringd. Leadet visas i din Lead-lista, tilldelat din säljare, med din receptionists kommentar.

Lägg till en procedur 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.

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.