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

# Shopmonkey

Com uma [ferramenta de webhook](/docs/pt/reception-ai/integrations/webhooks), sua recepcionista pode adicionar um agendamento ao calendário do Shopmonkey quando alguém ligar querendo levar o veículo até sua oficina.

> **Warning**
>
> O Shopmonkey não verifica conflitos quando um agendamento é criado dessa forma, então sua
> recepcionista pode reservar o mesmo horário duas vezes. Diga às pessoas que ligam que o horário é uma solicitação que sua oficina vai
> confirmar ou informe à sua recepcionista os horários de funcionamento e os limites de boxes nas instruções dela.

## Configuração

### Crie uma chave de API

No Shopmonkey, um administrador deve abrir **Settings** → **Integration** → **API Keys** e selecionar **Get Started** ou **Add New Key**. Selecione **Create API Key** e copie a chave imediatamente: o Shopmonkey a mostra apenas uma vez. A chave tem as mesmas permissões do usuário que a cria.

### Crie a ferramenta de webhook

No Reception.ai, acesse **Integrations**, selecione **Add integration** e escolha **Webhook Tool**.

| Campo                         | Valor                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome**                      | `create_shopmonkey_appointment`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Descrição**                 | "Adicione um agendamento ao calendário da oficina quando a pessoa que liga tiver escolhido um dia e horário. Primeiro, confirme o horário com ela."                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Método**                    | POST                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **URL**                       | `https://api.shopmonkey.cloud/v3/appointment`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Cabeçalhos da solicitação** | `Authorization`: `Bearer ` seguido da sua chave de API                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **Parâmetros do corpo**       | `name` (string, obrigatório): "O serviço e o nome da pessoa que liga, por exemplo: Troca de óleo - Jane Doe."  `startDate` (string, obrigatório): "O horário de início em UTC, no formato ISO 8601, por exemplo 2026-11-04T15:00:00.000Z."  `endDate` (string, obrigatório): "O horário de término no mesmo formato. Use uma hora após o início, a menos que o serviço solicitado demore mais."  `color` (string, obrigatório): "Sempre o valor exato `blue`."  `note` (string, obrigatório): "O nome, telefone, ano, marca e modelo do veículo da pessoa que liga, além do que ela precisa." |
| **Atribuir aos agentes**      | **Receptionist**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

Selecione **Enable**.

### Teste

[Teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) agendando uma troca de óleo. Verifique se o agendamento aparece no calendário do Shopmonkey no horário local correto.

`color` deve ser um destes valores: `aqua`, `black`, `blue`, `brown`, `gray`, `green`, `orange`, `purple`, `red` ou `yellow`. Use uma cor que sua equipe não use para outros agendamentos, para que os agendamentos por telefone se destaquem.

## Limitações

* A busca de clientes do Shopmonkey recebe uma lista de números de telefone, que as ferramentas de webhook não conseguem enviar. Por isso, sua recepcionista não consegue consultar pessoas que ligam nem vincular o agendamento a um registro de cliente ou veículo. A observação armazena os dados da pessoa que ligou.
* A ferramenta não consegue reagendar nem cancelar agendamentos. Essas ações exigem o ID do agendamento na URL.

## Solução de problemas

| Problema                                | O que verificar                                                                                                                           |
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| 401 do Shopmonkey                       | O cabeçalho deve ser `Bearer ` seguido de uma chave atual, com um espaço após `Bearer`.                                                   |
| Os agendamentos ficam no horário errado | Os horários devem estar em UTC. Adicione o fuso horário da sua oficina às instruções da recepcionista para que ela converta corretamente. |
| 400 sobre `color`                       | Use um dos nomes de cores do Shopmonkey, em minúsculas.                                                                                   |
| O agendamento não tem dados do cliente  | Faça a descrição orientar a recepcionista a coletar primeiro o nome, número e dados do veículo da pessoa que liga.                        |