Ir para a navegação
IntegraçõesGuias de configuraçãoServiços de campo

JobNimbus

Adicione novas pessoas que ligam ao JobNimbus como leads com uma ferramenta de webhook.

Com a ferramenta de webhook 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.

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.

CampoValor
Nomecreate_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étodoPOST
URLhttps://app.jobnimbus.com/api1/contacts
Cabeçalhos da solicitaçãoAuthorization: Bearer SUA_CHAVE_DE_API
Parâmetros do corpofirst_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 agentesReceptionist

Substitua Customer e Lead pelos nomes do seu fluxo de trabalho e status.

Selecione Enable e teste sua recepcionista como um novo interlocutor que precisa de uma inspeção no telhado. O contato aparecerá no JobNimbus com o status de lead.

Adicione um procedimento 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.

Solução de problemas

ProblemaO que verificar
401 ou 403 do JobNimbusO 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 statusrecord_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õesO Access Profile da chave não pode criar contatos. Crie uma nova chave com um perfil que possa.
Contatos não têm endereçoFaça a descrição informar à recepcionista que ela deve solicitar o endereço completo antes de adicionar o interlocutor.