Ir para a navegação
IntegraçõesGuias de configuraçãoAgendamento

Shopmonkey

Adicione solicitações de agendamento ao seu calendário do Shopmonkey com uma ferramenta de webhook.

Com uma ferramenta de webhook, sua recepcionista pode adicionar um agendamento ao calendário do Shopmonkey quando alguém ligar querendo levar o veículo até sua oficina.

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

1

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.

2

Crie a ferramenta de webhook

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

CampoValor
Nomecreate_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étodoPOST
URLhttps://api.shopmonkey.cloud/v3/appointment
Cabeçalhos da solicitaçãoAuthorization: Bearer seguido da sua chave de API
Parâmetros do corponame (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 agentesReceptionist

Selecione Enable.

3

Teste

Teste sua recepcionista 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

ProblemaO que verificar
401 do ShopmonkeyO cabeçalho deve ser Bearer seguido de uma chave atual, com um espaço após Bearer.
Os agendamentos ficam no horário erradoOs 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 colorUse um dos nomes de cores do Shopmonkey, em minúsculas.
O agendamento não tem dados do clienteFaça a descrição orientar a recepcionista a coletar primeiro o nome, número e dados do veículo da pessoa que liga.