ERPNext | ElevenLabs Documentation

Com as ferramentas de webhook abaixo, sua recepcionista pode reconhecer pessoas que ligam e já são leads do ERPNext, cadastrar novas pessoas que ligam como leads com nome, número de telefone e uma observação sobre o que precisam, além de deixar um comentário nos leads existentes para que sua equipe de vendas possa retornar a ligação. O ERPNext e o framework Frappe aceitam uma chave de API e um segredo estáticos, além de corpos de solicitação em JSON, portanto isso funciona no Frappe Cloud e em sites hospedados por você.

Antes de começar

Crie um usuário de API

No ERPNext, crie um usuário para o Reception.ai, por exemplo, reception@yourcompany.com, e atribua a ele apenas a função Sales User. As solicitações de API são executadas com as permissões desse usuário, então não use um administrador.

Gere as chaves

Abra o usuário, selecione a aba Settings, expanda API Access e selecione Generate Keys. Copie o API Secret do pop-up imediatamente: o ERPNext o exibe apenas uma vez. A API Key continua visível na mesma seção.

Cada ferramenta abaixo envia um cabeçalho de solicitação chamado Authorization com o valor token API_KEY:API_SECRET, com sua chave e segredo separados por dois-pontos. Defina o Type como Secret.

A chave e o segredo podem ler e alterar tudo o que a função Sales User permite. Não os compartilhe em documentos compartilhados e selecione Generate Keys novamente para substituí-los caso sejam vazados.

Encontre o endereço do seu site

As URLs das suas ferramentas começam com o endereço que você abre no navegador para usar o ERPNext. As tabelas abaixo usam https://YOUR-SITE.example.com; substitua-o pelo seu.

Crie as ferramentas

Para cada ferramenta, acesse Integrations, selecione Add integration, escolha Webhook Tool e defina Assign to agents como Receptionist. Defina Value como Fixed value para cada parâmetro marcado como “Sempre” abaixo.

Encontrar um lead

Campo	Valor
Nome	`find_erpnext_lead`
Descrição	”Encontre quem está ligando entre nossos leads pelo número de telefone. Use no início de uma ligação para verificar se essa pessoa já entrou em contato conosco.”
Método	GET
URL	`https://YOUR-SITE.example.com/api/resource/Lead`
Cabeçalhos da solicitação	`Authorization`: `token API_KEY:API_SECRET`
Parâmetros de consulta	`or_filters` (string, obrigatório): “Um filtro nos últimos sete dígitos do número de quem está ligando, exatamente como `[["mobile_no","like","%5550123%"],["phone","like","%5550123%"]]`.” `fields` (string): Sempre `["name","lead_name","status"]`. `limit_page_length` (integer): Sempre `5`.

Cadastrar um novo lead

Campo	Valor
Nome	`create_erpnext_lead`
Descrição	”Cadastre quem está ligando como um novo lead quando `find_erpnext_lead` não encontrá-lo.”
Método	POST
URL	`https://YOUR-SITE.example.com/api/resource/Lead`
Cabeçalhos da solicitação	`Authorization`: `token API_KEY:API_SECRET`
Parâmetros do corpo	`first_name` (string, obrigatório): “O primeiro nome de quem está ligando.” `last_name` (string): “O sobrenome de quem está ligando.” `mobile_no` (string, obrigatório): “O número de telefone de quem está ligando no formato internacional, por exemplo, +14155550123.” `email_id` (string): “O endereço de e-mail de quem está ligando, caso tenha informado um.” `lead_owner` (string): Sempre o endereço de e-mail do vendedor que retornará as ligações dos novos leads. `notes` (array): veja abaixo.

Para definir a origem dos leads, adicione source (string) como um valor fixo que corresponda exatamente a um dos seus registros de Lead Source. No ERPNext 16 e versões posteriores, o campo é utm_source, e ele deve corresponder a um registro de UTM Source.

notes preenche a aba Notes do lead. Dê a ele a descrição “Envie exatamente um item, com o que a pessoa que ligou precisa.” Em Each item, escolha object e selecione Add field para cada um destes campos:

note (string, obrigatório): “O que a pessoa que ligou precisa e quando gostaria de receber uma ligação de volta.”
added_by (string): Sempre o endereço de e-mail do usuário da API.

Registrar os detalhes da ligação

Campo	Valor
Nome	`add_erpnext_lead_comment`
Descrição	”Deixe um comentário no lead de quem está ligando com o que essa pessoa precisa. Use quando `find_erpnext_lead` encontrar a pessoa, com o nome do lead, como CRM-LEAD-2026-00012.”
Método	POST
URL	`https://YOUR-SITE.example.com/api/method/frappe.desk.form.utils.add_comment`
Cabeçalhos da solicitação	`Authorization`: `token API_KEY:API_SECRET`
Parâmetros do corpo	`reference_doctype` (string): Sempre `Lead`. `reference_name` (string, obrigatório): “O nome do lead, de `find_erpnext_lead` ou `create_erpnext_lead`.” `content` (string, obrigatório): “O que a pessoa que ligou precisa e quando gostaria de receber uma ligação de volta.” `comment_email` (string): Sempre o endereço de e-mail do usuário da API. `comment_by` (string): Sempre `Reception.ai`.

Selecione Enable em cada ferramenta e, em seguida, teste sua recepcionista como uma nova pessoa que liga e pede para receber uma ligação de volta. O lead aparecerá na sua lista de Lead, atribuído ao seu vendedor, com o comentário da sua recepcionista.

Adicione um procedimento para quem liga: encontre o lead e, se ele não for encontrado, cadastre a pessoa com uma observação; caso contrário, registre os detalhes da ligação no lead encontrado. Adicione uma regra para que sua recepcionista nunca leia registros de leads para quem liga.

Sua recepcionista cria o filtro de busca a partir da conversa, então quem liga pode tentar fazer com que ela procure os leads de outras pessoas. A ferramenta retorna apenas até cinco nomes e status, mas mantenha a regra acima. Se Sales User conceder mais acesso do que você deseja, como a clientes e cotações, crie uma função personalizada que possa apenas ler, criar e comentar em leads.

Limitações

A busca procura os últimos sete dígitos do número. Números armazenados com espaços ou hífens dentro desses dígitos não são encontrados, e duas pessoas podem ter os mesmos últimos sete dígitos.
Esta configuração cobre apenas leads. Sua recepcionista não busca contatos ou clientes nem cria oportunidades.

Solução de problemas

Problema	O que verificar
401 ou 403 do ERPNext	O valor do cabeçalho deve ser `token`, um espaço e, em seguida, a chave e o segredo unidos por dois-pontos. Verifique se o usuário está ativado e tem Sales User.
Pessoas conhecidas não são encontradas	Armazene os números sem espaços ou hífens e verifique se o número está no campo Mobile No ou Phone do lead.
Erro sobre o proprietário do lead ou a origem	`lead_owner` deve ser o endereço de e-mail de um usuário ativado, e `source` deve corresponder exatamente a uma Lead Source (`utm_source` e uma UTM Source no ERPNext 16 e versões posteriores).
Erro sobre o número de telefone	O ERPNext valida números de telefone. Instrua sua recepcionista a enviar apenas dígitos, com um `+` opcional no início.
Erro sobre `added_by`	`added_by` em `notes` deve ser o endereço de e-mail de um usuário ativado, como o usuário da API.
O comentário não é adicionado	`reference_name` deve ser o nome de um lead existente, como `CRM-LEAD-2026-00012`. Verifique se a ferramenta de encontrar ou criar foi executada primeiro.