> 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. # JobNimbus Com a [ferramenta de webhook](/docs/pt/reception-ai/integrations/webhooks) abaixo, sua recepcionista pode adicionar um novo interlocutor ao JobNimbus como contato no fluxo de trabalho de leads, com telefone, endereço e o que ele precisa, para que sua equipe possa fazer o acompanhamento. ## Antes de começar 1. No JobNimbus, selecione o ícone do seu perfil no canto superior direito, depois **Settings** → **API**, e crie uma nova chave de API. 2. Escolha um **Access Profile** que possa criar contatos e tenha apenas as permissões necessárias. A chave mantém as permissões que o perfil tinha quando você a criou. 3. Copie a chave de API completa, não o **Key ID**. O JobNimbus a exibe apenas uma vez. A ferramenta envia a chave no cabeçalho de solicitação `Authorization` como `Bearer SUA_CHAVE_DE_API`. > **Warning** > > A chave de API dá acesso aos seus dados do JobNimbus. Armazene-a com segurança e não a compartilhe. Novas chaves > expiram após um ano, portanto, crie uma substituta antes disso. Você também precisa dos nomes exatos do fluxo de trabalho de contatos e do status em que novos leads devem entrar, conforme aparecem nas configurações do JobNimbus, por exemplo, `Customer` e `Lead`. ## Criar a ferramenta Acesse **Integrations**, selecione **Add integration**, escolha **Webhook Tool** e preencha os campos abaixo. | Campo | Valor | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `create_jobnimbus_contact` | | **Descrição** | "Adicione o interlocutor ao nosso CRM como um novo lead quando ele precisar de um serviço e ainda não tiver usado nossos serviços." | | **Método** | POST | | **URL** | `https://app.jobnimbus.com/api1/contacts` | | **Cabeçalhos da solicitação** | `Authorization`: `Bearer SUA_CHAVE_DE_API` | | **Parâmetros do corpo** | `first_name` (string, obrigatório): "O primeiro nome do interlocutor." `last_name` (string, obrigatório): "O sobrenome do interlocutor." `record_type_name` (string, obrigatório): "Sempre o valor exato `Customer`." `status_name` (string, obrigatório): "Sempre o valor exato `Lead`." `mobile_phone` (string, obrigatório): "O telefone do interlocutor, somente dígitos." `email` (string): "O endereço de e-mail do interlocutor, caso ele tenha fornecido um." `address_line1` (string): "O endereço onde o serviço é necessário." `city` (string): "A cidade desse endereço." `state_text` (string): "O estado, como uma sigla de duas letras." `zip` (string): "O CEP." `description` (string, obrigatório): "O que o interlocutor precisa, quando está disponível e qualquer outra informação que ele tenha fornecido." | | **Atribuir a agentes** | **Receptionist** | Substitua `Customer` e `Lead` pelos nomes do seu fluxo de trabalho e status. Selecione **Enable** e [teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) como um novo interlocutor que precisa de uma inspeção no telhado. O contato aparecerá no JobNimbus com o status de lead. > **Tip** > > Adicione um [procedimento](/docs/pt/reception-ai/receptionist/rules-and-procedures) informando à sua recepcionista > que ela deve coletar o endereço completo antes de adicionar o interlocutor. ## Limitações * A busca de contatos no JobNimbus exige um filtro de busca em JSON, portanto, esta ferramenta não pode procurar interlocutores. Um interlocutor recorrente pode ser adicionado duas vezes. * Serviços, tarefas e notas são vinculados a um contato por campos aninhados, que as ferramentas de webhook não podem enviar. A descrição do contato armazena os detalhes da chamada. Para procurar interlocutores por e-mail e criar serviços vinculados ao contato deles, use as ações **Find Contact by Email**, **Create Contact** e **Create Job** do JobNimbus pelo [Zapier](/docs/pt/reception-ai/integrations/zapier). ## Solução de problemas | Problema | O que verificar | | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | 401 ou 403 do JobNimbus | O valor do cabeçalho deve ser `Bearer` seguido da chave de API completa, e não do **Key ID**. Verifique se a chave não expirou. | | Erro sobre o fluxo de trabalho ou status | `record_type_name` e `status_name` devem corresponder exatamente a um fluxo de trabalho de contatos e a um de seus status. | | 403 com uma mensagem de permissões | O **Access Profile** da chave não pode criar contatos. Crie uma nova chave com um perfil que possa. | | Contatos não têm endereço | Faça a descrição informar à recepcionista que ela deve solicitar o endereço completo antes de adicionar o interlocutor. |