> 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.

# ServiceM8

Com as [ferramentas de webhook](/docs/pt/reception-ai/integrations/webhooks) 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](/docs/pt/reception-ai/receptionist/testing) 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](/docs/pt/reception-ai/integrations/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.          |