> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # ERPNext Com as [ferramentas de webhook](/docs/pt/reception-ai/integrations/webhooks) 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**. > **Warning** > > 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](/docs/pt/reception-ai/receptionist/testing) 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. > **Tip** > > Adicione um [procedimento](/docs/pt/reception-ai/receptionist/rules-and-procedures) 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. > **Warning** > > 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. |