HighLevel | ElevenLabs Documentation

HighLevel também é conhecido como GoHighLevel, e sua API funciona com o nome LeadConnector. Com uma ferramenta de webhook, sua recepcionista pode salvar cada pessoa que liga como contato na sua subconta do HighLevel. Se quem liga já for um contato, o HighLevel atualiza o registro existente em vez de criar uma duplicata.

Configuração

Crie um token de integração privada

Na sua subconta do HighLevel, abra Configurações → Integrações privadas e selecione Criar nova integração. Dê um nome a ela, selecione apenas os escopos para visualizar e editar contatos e crie a integração. Copie o token imediatamente: o HighLevel o exibe apenas uma vez.

Se Integrações privadas não estiver nas suas configurações, peça ao administrador da sua agência para conceder acesso.

Encontre seu ID de localização

Abra Configurações → Perfil comercial na mesma subconta e copie o ID de localização.

Crie a ferramenta de webhook

No Reception.ai, acesse Integrações, selecione Adicionar integração e escolha Ferramenta de webhook.

Campo	Valor
Nome	`save_highlevel_contact`
Descrição	”Salve quem está ligando como contato no nosso CRM quando souber o nome e o número de telefone. Use em todas as chamadas de clientes novos ou recorrentes.”
Método	POST
URL	`https://services.leadconnectorhq.com/contacts/upsert`
Cabeçalhos da solicitação	`Authorization`: `Bearer` seguido do seu token `Version`: `2021-07-28`
Parâmetros do corpo	`locationId` (string, obrigatório): “Sempre o valor exato `LOCATION_ID`.” `firstName` (string, obrigatório): “O primeiro nome de quem está ligando.” `lastName` (string): “O sobrenome de quem está ligando, caso tenha informado.” `phone` (string, obrigatório): “O número de telefone de quem está ligando no formato internacional, por exemplo +14155550123.” `email` (string): “O endereço de e-mail de quem está ligando, caso tenha informado.” `source` (string, obrigatório): “Sempre o valor exato `Reception.ai phone call`.”
Atribuir a agentes	Recepcionista

Substitua LOCATION_ID pelo ID que você copiou. Selecione Ativar.

Teste

Teste sua recepcionista com uma chamada em que você informa seu nome e número. O contato aparece no HighLevel em Contatos. Ligue novamente com o mesmo número: o HighLevel atualiza esse contato em vez de adicionar um novo.

O token pode ler e alterar seus contatos. Não o inclua em documentos compartilhados e exclua a integração privada no HighLevel se ele vazar.

O HighLevel decide se quem liga já é um contato usando a configuração Permitir contato duplicado da subconta. Se essa configuração comparar tanto e-mail quanto telefone, ele os verifica na ordem listada na configuração.

Para fazer mais após uma chamada, como abrir uma oportunidade ou avisar sua equipe, crie um workflow do HighLevel que comece com o gatilho Webhook de entrada. Aponte uma segunda ferramenta de webhook para a URL do workflow com os campos necessários e mapeie esses campos dentro do workflow. Trate a URL do workflow como um segredo. O HighLevel lista o Webhook de entrada como um gatilho premium, então verifique seu plano quanto a cobranças de uso.

Limitações

O servidor MCP do HighLevel exige login OAuth, que o Reception.ai não oferece suporte. Use a ferramenta de webhook.
Tags e campos personalizados são listas na API do HighLevel, e as ferramentas de webhook enviam valores simples. Em vez disso, defina-os com um workflow.
Adicionar notas ou tarefas exige o ID do contato na URL, que uma ferramenta de webhook não consegue preencher durante uma chamada. Use um workflow de Webhook de entrada para isso.

Solução de problemas

Problema	O que verificar
401 do HighLevel	O cabeçalho `Authorization` deve ser `Bearer` seguido do token, com um espaço após `Bearer`.
403 do HighLevel	O token precisa dos escopos de contato, e `locationId` deve ser da subconta em que o token foi criado.
O HighLevel rejeita a versão	O cabeçalho `Version` deve ser exatamente `2021-07-28`. Se a documentação da API do HighLevel listar um valor obrigatório mais recente, use-o.
Pessoas que ligam novamente são duplicadas	Verifique a configuração Permitir contato duplicado e se os números de telefone estão salvos no mesmo formato internacional.
O contato não tem nome	Faça a descrição da ferramenta instruir a recepcionista a pedir o nome de quem está ligando antes de salvá-lo.