> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # EspoCRM Com as [ferramentas de webhook](/docs/pt/reception-ai/integrations/webhooks) abaixo, sua recepcionista pode reconhecer pessoas que ligam e já estão no EspoCRM e adicionar novas pessoas como leads, com nome, número de telefone e o que precisam, para que sua equipe possa fazer o acompanhamento. A API do EspoCRM aceita uma chave de API estática e corpos de solicitação JSON, portanto funciona da mesma forma no EspoCRM Cloud e em instalações hospedadas por você. ## Antes de começar ### Crie uma função No EspoCRM, acesse **Administração** → **Funções** e crie uma função que possa ler e criar **Leads** e ler **Contatos**. Deixe todos os outros escopos desativados. ### Crie um usuário da API Acesse **Administração** → **Usuários da API** e crie um usuário. Defina o método de autenticação como **Chave de API** e atribua a função que você acabou de criar. Salve e copie a chave de API na visualização de detalhes do usuário. Cada ferramenta abaixo envia a chave em um cabeçalho de solicitação chamado `X-Api-Key`. Defina o **Tipo** como **Segredo**. > **Warning** > > A chave de API pode ler e alterar tudo o que a função dela permitir. Mantenha a função limitada e gere uma nova > chave no EspoCRM caso ela seja exposta. ### Encontre o endereço do seu EspoCRM As URLs das suas ferramentas começam com o endereço que você abre no navegador para usar o EspoCRM, seguido de `/api/v1/`. As tabelas abaixo usam `https://YOUR-CRM.example.com`; substitua-o pelo seu endereço. ## Crie as ferramentas Para cada ferramenta, acesse **Integrações**, selecione **Adicionar integração**, escolha **Ferramenta de webhook** e defina **Atribuir a agentes** como **Recepcionista**. Defina **Valor** como **Valor fixo** para todos os parâmetros marcados como "Sempre" abaixo. ### Encontre um lead | Campo | Valor | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Nome** | `find_espocrm_lead` | | **Descrição** | "Encontre a pessoa que liga entre nossos leads pelo número de telefone. Use no início da chamada para verificar se ela já entrou em contato conosco." | | **Método** | GET | | **URL** | `https://YOUR-CRM.example.com/api/v1/Lead` | | **Cabeçalhos da solicitação** | `X-Api-Key`: sua chave de API | | **Parâmetros de consulta** | `textFilter` (string, obrigatório): "O número de telefone da pessoa que liga com o código do país, por exemplo +14155550123." `select` (string): Sempre `id,name,status`. `maxSize` (integer): Sempre `5`. | Para também reconhecer clientes existentes, crie uma segunda ferramenta chamada `find_espocrm_contact` com as mesmas configurações e a URL `https://YOUR-CRM.example.com/api/v1/Contact`. ### Adicione um novo lead | Campo | Valor | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `create_espocrm_lead` | | **Descrição** | "Adicione a pessoa que liga como um novo lead quando `find_espocrm_lead` não a encontrar." | | **Método** | POST | | **URL** | `https://YOUR-CRM.example.com/api/v1/Lead` | | **Cabeçalhos da solicitação** | `X-Api-Key`: sua chave de API | | **Parâmetros do corpo** | `firstName` (string, obrigatório): "O primeiro nome da pessoa que liga." `lastName` (string, obrigatório): "O sobrenome da pessoa que liga." `phoneNumber` (string, obrigatório): "O número de telefone da pessoa que liga em formato internacional, por exemplo +14155550123." `emailAddress` (string): "O endereço de e-mail da pessoa que liga, se ela fornecer um." `description` (string, obrigatório): "O que a pessoa que liga precisa e quando gostaria de receber uma ligação de volta." `status` (string): Sempre `New`. `source` (string): Sempre `Call`. | Para encaminhar novos leads para um vendedor, adicione `assignedUserId` (string) como um valor fixo com o ID desse usuário. Você pode ver o ID na barra de endereços ao abrir o usuário no EspoCRM. Selecione **Ativar** em cada ferramenta e, em seguida, [teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) como uma nova pessoa que liga pedindo um orçamento. O lead aparecerá no EspoCRM com o status **New** e a origem **Call**. > **Tip** > > Adicione um [procedimento](/docs/pt/reception-ai/receptionist/rules-and-procedures) para que sua recepcionista > pesquise primeiro e só adicione um lead quando nenhuma correspondência for encontrada. > **Warning** > > A pesquisa também encontra nomes e endereços de e-mail, portanto uma pessoa que liga pode tentar consultar outra pessoa. > Adicione uma regra para que sua recepcionista nunca leia registros do CRM para pessoas que ligam e mantenha **select** > limitado a `id,name,status`. ## Limitações * `textFilter` usa a mesma pesquisa da caixa de busca do EspoCRM: ela procura em nomes, endereços de e-mail e números de telefone. Uma busca por número de telefone também pode encontrar outro registro cujo número comece com os mesmos dígitos, portanto sua recepcionista deve confirmar o nome da pessoa que liga. * Sua recepcionista não pode adicionar uma nota ou tarefa a um lead ou contato existente com essas ferramentas. A descrição do novo lead contém os detalhes da chamada. * As ferramentas não definem equipes. O EspoCRM recebe equipes como uma lista de IDs de equipe (`teamsIds`), e uma ferramenta de webhook sempre preenche uma lista com base na conversa, portanto ela não pode adicionar todos os leads à mesma equipe, e sua recepcionista não deve escolher equipes. Use `assignedUserId` para encaminhar leads. ## Solução de problemas | Problema | O que verificar | | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 do EspoCRM | O cabeçalho deve se chamar `X-Api-Key` e conter a chave da visualização de detalhes do usuário da API. Verifique se o usuário da API está ativo. | | 403 do EspoCRM | A função do usuário da API não pode ler ou criar leads. Edite a função em **Administração** → **Funções**. | | 409 ao adicionar um lead | O EspoCRM encontrou uma possível duplicata, como um lead com o mesmo nome ou endereço de e-mail. Sua recepcionista deve pesquisar primeiro. | | Pessoas conhecidas que ligam não são encontradas | Armazene os números de telefone em formato internacional, como `+14155550123`, e verifique se o número está em um lead ou contato, não apenas em uma conta. | | Erros de `status` ou `source` | Os valores devem corresponder exatamente às opções de **Status** e **Origem** do seu lead, conforme definidas em **Administração** → **Gerenciador de entidades** → **Lead**. |