> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # HighLevel HighLevel também é conhecido como GoHighLevel, e sua API funciona com o nome LeadConnector. Com uma [ferramenta de webhook](/docs/pt/reception-ai/integrations/webhooks), 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](/docs/pt/reception-ai/receptionist/testing) 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. > **Warning** > > 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. > **Tip** > > 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. |