ServiceM8 | ElevenLabs Documentation

Com as ferramentas de webhook abaixo, sua recepcionista pode criar um orçamento ou trabalho no ServiceM8 quando alguém liga precisando de um serviço, além de adicionar novas pessoas como clientes.

Antes de começar

No ServiceM8, abra Settings → API Keys e crie uma chave. Todas as ferramentas abaixo a enviam no cabeçalho de solicitação X-Api-Key. Qualquer pessoa com a chave pode ler e alterar seus dados do ServiceM8, então não a deixe em documentos compartilhados.

Crie as ferramentas

Para cada ferramenta, acesse Integrations, selecione Add integration, escolha Webhook Tool e defina Assign to agents como Receptionist.

Crie um trabalho

Campo	Valor
Nome	`create_servicem8_job`
Descrição	”Crie um trabalho quando alguém ligar precisando de um serviço ou querendo um orçamento.”
Método	POST
URL	`https://api.servicem8.com/api_1.0/job.json`
Cabeçalhos da solicitação	`X-Api-Key`: sua chave de API
Parâmetros do corpo	`status` (string, obrigatório): “Sempre o valor exato `Quote`.” `job_address` (string, obrigatório): “O endereço completo onde o serviço é necessário, incluindo o CEP.” `job_description` (string, obrigatório): “O nome e o número de telefone de quem ligou, depois o que precisa ser feito e todos os detalhes fornecidos.”

Use Work Order em vez de Quote se as chamadas devem ir direto para trabalhos agendados.

Adicione um novo cliente

Campo	Valor
Nome	`create_servicem8_client`
Descrição	”Adicione quem ligou como novo cliente quando disser que nunca usou nossos serviços antes.”
Método	POST
URL	`https://api.servicem8.com/api_1.0/company.json`
Cabeçalhos da solicitação	`X-Api-Key`: sua chave de API
Parâmetros do corpo	`name` (string, obrigatório): “O nome completo de quem ligou ou o nome da empresa.” `address` (string): “O endereço do cliente, incluindo o CEP.”

Selecione Enable em cada ferramenta e, em seguida, teste sua recepcionista pedindo um orçamento. O novo orçamento aparecerá no ServiceM8.

Limitações

O ServiceM8 responde a ambas as ferramentas apenas com OK. O ID do novo registro fica em um cabeçalho de resposta que sua recepcionista não consegue ler, portanto ela não pode vincular o trabalho ao cliente. Sua equipe faz essa vinculação no ServiceM8.
O ServiceM8 armazena números de telefone e e-mails nos contatos de um cliente, um registro separado que a ferramenta de cliente não pode criar. Em vez disso, a descrição do trabalho guarda o número de quem ligou.
A busca por um cliente existente requer um parâmetro $filter, e os nomes de parâmetros de ferramentas de webhook não podem conter $, então sua recepcionista não pode pesquisar quem liga.

Para criar clientes e trabalhos vinculados, use as ações Create Client e Create Job do ServiceM8 pelo Zapier.

Solução de problemas

Problema	O que verificar
401 do ServiceM8	O cabeçalho precisa se chamar `X-Api-Key` e conter uma chave atual.
400 relacionado ao status	`status` precisa ser exatamente `Quote`, `Work Order`, `Unsuccessful` ou `Completed`.
O trabalho não tem endereço	Faça a descrição instruir a recepcionista a pedir o endereço completo antes de criar o trabalho.
429 do ServiceM8	Você atingiu o limite de solicitações do ServiceM8. Espere um minuto e tente novamente.