EspoCRM | ElevenLabs Documentation

Com as ferramentas de webhook 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.

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 como uma nova pessoa que liga pedindo um orçamento. O lead aparecerá no EspoCRM com o status New e a origem Call.

Adicione um procedimento para que sua recepcionista pesquise primeiro e só adicione um lead quando nenhuma correspondência for encontrada.

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.