saas de agendamento
WhatsApp para sistema de agendamento: o cliente escolhe o horário sem sair da conversa
Ligue o WhatsApp ao seu sistema de agendamento: os horários livres viram uma lista que o cliente toca, a escolha volta como reserva e o lembrete sai no número de cada negócio, com ligação e SMS para quem não responder.
SaaS testa 14 dias com o time técnico ajudando na integração.
- conexões na D-API
- 1.875
- de uptime garantido em contrato
- 99,9%
- datacenters no Brasil
- 4
- por ligação de WhatsApp na API não-oficial
- R$ 0
Horário escolhido com um toque
A sua agenda gera a lista de horários livres. O rowId de cada linha é o slot, e a escolha chega pronta no webhook.
Lembrete que não sai duplicado
Envio em fila com commandId e resultado por webhook. O seu sistema sabe o que saiu e o que falhou, sem polling.
Escalada para voz e SMS
Quem não respondeu recebe uma ligação com menu por tecla ou um SMS, a partir da mesma conta e com o mesmo padrão de webhook.
Um sistema de agendamento vive de dois números: horário ocupado e horário cumprido. O WhatsApp para sistema de agendamento mexe nos dois. Quando o cliente final reserva pela conversa, sem ligar e sem abrir outro app, a agenda enche mais fácil. Quando o lembrete chega no número do estabelecimento e a resposta volta para o sistema, o horário reservado vira horário cumprido ou volta a ficar livre a tempo de outra pessoa ocupar.
Salão, barbearia, estúdio de pilates, assistência técnica, consultório: o segmento muda, o fluxo é parecido. Esta página mostra como montar esse fluxo com a D-API dentro do seu produto, cuidando dos pontos que costumam quebrar em agenda, como reserva duplicada e lembrete repetido.
Cada negócio com o próprio WhatsApp
O cliente final responde muito melhor ao número que já conhece. Por isso cada estabelecimento do seu sistema conecta o próprio WhatsApp, numa conexão isolada criada pelo seu backend com POST /api/v1/sessions. A tela de configuração do seu produto mostra o QR code, o dono do negócio escaneia e pronto. A partir daí, tudo o que a agenda envia sai daquele número, e tudo o que o cliente responde chega no seu webhook com o sessionId do estabelecimento.
Um negócio com duas unidades, ou com profissionais que atendem pelo próprio número, pode ter várias conexões. O seu banco decide de qual conexão sai cada mensagem.
Oferecer horários numa lista
O fluxo de reserva começa quando o cliente escreve “quero marcar”. O seu sistema consulta a disponibilidade e responde com uma mensagem interativa de lista, em que cada linha é um horário livre e o rowId carrega o identificador do slot:
POST /api/v1/interactive/send/list
{
"sessionId": "studio-412",
"to": "5521988887777",
"title": "Horários de quinta, 21/11",
"description": "Escolha um horário para a aula experimental.",
"buttonText": "Ver horários",
"sections": [{
"title": "Manhã",
"rows": [
{ "rowId": "slot-9f21", "title": "07h00", "description": "Prof. Renata" },
{ "rowId": "slot-9f22", "title": "08h30", "description": "Prof. Renata" },
{ "rowId": "slot-9f30", "title": "10h00", "description": "Prof. Diego" }
]
}]
}
A escolha chega no webhook messages.received com type: "list_response", e o selected_row_id traz o slot. A referência da API indica o limite da Meta de 10 linhas no total por lista, então agendas cheias funcionam melhor em dois passos: primeiro o dia, depois os horários daquele dia. Os detalhes de cada campo estão na documentação da D-API.
Reserva que aguenta dois clientes no mesmo horário
A lista mostra o que estava livre no momento do envio. Até o cliente tocar, alguém pode ter ocupado o horário pelo site ou pelo balcão. O seu handler precisa tratar isso como qualquer reserva concorrente:
async function onListResponse(evt: ListResponseEvent) {
const slotId = evt.data.data.selected_row_id;
const shop = await shops.findBySessionId(evt.sessionId);
if (!shop) return;
const phone = phoneFromJid(evt.data.from.jid);
const reserved = await slots.reserveIfFree(shop.id, slotId, phone);
const text = reserved
? `Reservado: ${reserved.label}. Você recebe um lembrete na véspera.`
: "Esse horário acabou de ser ocupado. Quer ver os próximos?";
await jobs.enqueue("send-text", { sessionId: evt.sessionId, to: phone, text });
}
A reserva é uma operação atômica no seu banco (um UPDATE ... WHERE status = 'livre' resolve), e a resposta ao cliente sai por um worker. O webhook responde 2xx logo depois de enfileirar, porque a D-API espera até 30 segundos e retenta em caso de falha.
Lembrete com envio em fila
Lembrete é volume concentrado: às 18h da véspera, o seu sistema pode ter milhares de mensagens para enviar ao mesmo tempo, em centenas de conexões. O envio síncrono segura cada request até a mensagem sair. Com async: true, a D-API enfileira o comando, responde na hora com um commandId e avisa o resultado no webhook command.result.
Esse commandId é a sua chave de idempotência. Guarde junto do agendamento no momento do envio e, quando o resultado chegar, marque o lembrete como enviado ou falho. Como a entrega do command.result tem retentativa, o mesmo resultado pode chegar mais de uma vez, e o commandId evita contar duas vezes. Quando o lembrete tem duas partes, como o texto e a localização do estabelecimento, sequential: true garante que saiam na ordem. O guia de comandos assíncronos cobre os detalhes.
Quem não respondeu recebe uma ligação
O lembrete em texto resolve a maior parte da agenda. Para o resto, o seu sistema pode subir um degrau sem trocar de fornecedor.
Ligação de URA com menu por tecla. POST /api/v1/voice/call com um flowId executa um fluxo de URA montado no builder do painel: toca o áudio “sua aula é amanhã às 7h, pressione 1 para confirmar ou 2 para remarcar” e envia cada tecla como evento call.dtmf. O campo maxAttempts define quantas vezes tentar se ninguém atender. Para avisar uma lista inteira de uma vez, o disparo de voz em massa aceita scheduledAt e variáveis por destinatário.
Ligação de WhatsApp pelo número do negócio. Na API não-oficial, a chamada sai do WhatsApp do estabelecimento, sem custo extra por ligação, a partir de um botão na tela da agenda.
SMS. Para o cliente que não tem WhatsApp naquele número, POST /api/v1/sms/send envia o lembrete pela API de SMS, com status de entrega por webhook.
Atendimento remoto com convite de chamada
Nem todo serviço agendado é presencial. Consultoria, aula particular, mentoria e suporte técnico remoto podem receber um convite de chamada no próprio WhatsApp. POST /api/v1/calls/send-event envia ao cliente um evento com título e horário, criando um link de chamada do WhatsApp de áudio ou vídeo ou usando a URL de outra ferramenta de reunião. O convite fica na conversa, ao lado do lembrete.
Régua configurável pelo próprio cliente
Alguns sistemas de agendamento querem deixar o estabelecimento decidir a própria régua: lembrete 48 horas antes ou só na véspera, mensagem de pós-atendimento, pedido de avaliação. Você pode construir essa configuração no seu produto, chamando a API a partir do seu scheduler. Ou pode usar o builder de automação da D-API, em que um fluxo começa por um gatilho de webhook disparado pelo seu sistema e segue com blocos de WhatsApp, Atraso, Condição, SMS e Ligação (URA).
Por onde começar
O primeiro passo é a lista de horários, porque é ela que muda a experiência do cliente final. Conecte um número de teste, gere a lista a partir da sua disponibilidade real e trate o list_response com a reserva atômica. Depois, mova os lembretes para o envio assíncrono e acrescente a ligação para os horários não confirmados. A visão completa de como modelar conexões e cobrança está na página de API de WhatsApp para SaaS.
Time D-API. Atualizado em .
Perguntas frequentes
A D-API agenda o envio dos lembretes?
Para mensagens de WhatsApp, quem decide a hora é o seu sistema: o seu scheduler chama a API no momento certo. Campanhas de voz aceitam scheduledAt, e o builder de automação tem o bloco Atraso para quem prefere montar a régua no painel.
Quantos horários cabem numa lista?
A referência da API indica o limite da Meta de até 10 linhas no total, com título de linha de até 24 caracteres. Para mais opções, ofereça primeiro o dia e depois os horários daquele dia.
Cada estabelecimento do meu sistema usa o próprio número?
Sim. Cada negócio conecta o próprio WhatsApp numa conexão isolada, criada pelo seu backend. O seu banco liga o sessionId ao estabelecimento.
Preciso usar a API Oficial para mandar lembrete?
Não necessariamente. Na API não-oficial, a mensagem sai livre, sem template e sem tarifa por mensagem. Se o estabelecimento usar a API Oficial, o lembrete fora da janela de 24 horas sai como template aprovado.