Tema
Integrações da agenda
A Agenda conversa com outros sistemas de três jeitos. Tudo é configurado pelo dono, em Configurações, na aba API e Integrações: funcionário não enxerga essa área. As integrações da agenda só funcionam com o módulo Agenda ativo.
Três jeitos de integrar
| Jeito | Para quê | Precisa programar |
|---|---|---|
| Avisos automáticos (webhooks) com Zapier ou Make | Copiar cada agendamento para uma planilha, para o Google Agenda ou avisar a equipe num grupo | Não |
| API | O seu site, sistema ou ERP consulta horários e cria agendamentos | Sim, um desenvolvedor |
| Assistente de IA (MCP) | Pedir em português: "quem está agendado para amanhã?" | Não |
Os avisos da agenda
O Konversia avisa outro sistema na hora em que algo acontece com um agendamento. São seis avisos, que você marca no cadastro do destino (veja Webhooks).
| Evento | Quando acontece |
|---|---|
| Agendamento criado | Um agendamento entrou na Agenda, por qualquer caminho: equipe, link público, workflow ou integração |
| Agendamento remarcado | O agendamento mudou de horário |
| Agendamento confirmado | O cliente ou a equipe confirmou o agendamento |
| Agendamento cancelado | O agendamento foi cancelado, pela empresa ou pelo cliente |
| Agendamento concluído | O atendimento foi marcado como concluído |
| Cliente não compareceu ao agendamento | O agendamento foi marcado como não compareceu |
O que vem em cada aviso:
- o serviço e a duração;
- o dia e o horário, já no fuso da empresa;
- o nome e o telefone do cliente;
- a situação do agendamento;
- o valor e o pagamento;
- a observação e o responsável;
- quem cancelou e o motivo;
- o link da página da reserva;
- na remarcação, o horário anterior.
O que não gera aviso
Agendamento ligado a uma conversa privada não é enviado. Quando o agendamento não está ligado a nenhuma conversa, ele também não é enviado se o cliente tiver alguma conversa privada. E registrar um pagamento também não gera aviso.
Cuidado com o link da reserva
Quem abre o link da página da reserva consegue remarcar e cancelar o agendamento, sem senha. Mande esse link só para o próprio cliente. Não cole em planilha, evento de calendário, grupo ou qualquer lugar que outras pessoas veem.
Receita 1: planilha com todos os agendamentos
Com o Zapier:
- No Zapier, crie um Zap com o gatilho Webhooks by Zapier, evento Catch Hook, e copie o endereço gerado.
- No Konversia, em Configurações, API e Integrações, seção Webhooks, crie um destino com esse endereço e marque Agendamento criado. Guarde o segredo mostrado: ele aparece uma vez só.
- Crie um agendamento de teste na Agenda e clique em Test trigger no Zapier.
- Acrescente a ação Google Sheets, evento Create Spreadsheet Row, e ligue as colunas: Data =
data.appointment.date; Hora =data.appointment.start; Serviço =data.appointment.service.name; Cliente =data.appointment.contact.name; Telefone =data.appointment.contact.phone_number; Valor =data.appointment.price_cents; Situação =data.appointment.status; Número =data.appointment.id. - Publique o Zap.
Dicas
O valor vem em centavos (5000 é R$ 50,00). Divida por 100 com um passo Formatter ou com uma fórmula na planilha.
Para a planilha acompanhar cancelamentos e remarcações, marque também esses eventos no destino e use Lookup Spreadsheet Row pelo Número antes de Update Spreadsheet Row.
No Make o caminho é o mesmo, com Webhooks, Custom webhook e Google Sheets, Add a Row.
Receita 2: Google Agenda da equipe
- Comece como na Receita 1, marcando no destino Agendamento criado, Agendamento remarcado e Agendamento cancelado.
- Separe o caminho pelo tipo do aviso (campo
type): Paths no Zapier, Router no Make. - Para
appointment.created, use a ação Google Calendar, Create Detailed Event. Título = serviço + nome do cliente; início =data.appointment.starts_at; fim =data.appointment.ends_at; descrição = telefone do cliente e a linha "Konversia 128", com odata.appointment.id. Não inclua o link da reserva: a agenda da equipe é compartilhada, e quem abre esse link consegue remarcar e cancelar o agendamento. - Para
appointment.rescheduled, use Find Event procurando por "Konversia "data.appointment.id, e depois Update Event com o novo início e fim.
- Para
appointment.canceled, use Find Event do mesmo jeito e depois Delete Event.
Fuso
starts_at e ends_at já carregam o fuso (vêm no horário universal), então o Google Agenda mostra o horário certo sem ajuste. Não use date + start para montar o evento, a menos que informe o fuso da empresa no passo.
Receita 3: aviso no grupo da equipe
- Crie um destino com Agendamento cancelado e Cliente não compareceu ao agendamento.
- Acrescente a ação de mensagem do aplicativo que a equipe usa: Slack, Microsoft Teams, Telegram, Discord ou e-mail.
- Para o cancelamento, um texto sugerido é "Maria Souza cancelou Corte de 06/10 às 14:00. Motivo: imprevisto.", montado com
data.appointment.contact.name,data.appointment.service.name,data.appointment.date,data.appointment.startedata.appointment.cancel_reason. - Para avisar só quando o cancelamento partiu do cliente, coloque um filtro: siga apenas se
data.appointment.canceled_byforcontact.
Dentro do próprio Konversia a equipe já é avisada quando o cliente confirma ou cancela (veja Mensagens e confirmação). Esta receita serve para levar o aviso a um lugar de fora.
O que precisa de um desenvolvedor
Alguns casos pedem a API, e não só os avisos:
- mostrar os horários livres no site da empresa e agendar por lá;
- o ERP ou sistema de gestão criar, remarcar, cancelar e confirmar agendamentos;
- marcar como concluído ou falta e registrar pagamento a partir de outro sistema.
O que entregar ao desenvolvedor: uma chave de API com as permissões da Agenda (veja Chaves de API) e a documentação da Agenda para desenvolvedores.
O que você vê na tela:
- o agendamento criado pela integração aparece no calendário como qualquer outro, com Origem: API no painel;
- se o cliente ainda não era um contato, o contato e a conversa são criados na linha escolhida;
- os lembretes e a mensagem após o atendimento seguem as mensagens da Agenda normalmente;
- a mensagem Ao agendar só sai se a integração pedir, e para isso a chave precisa também da permissão Enviar mensagens.
Quem domina o Zapier ou o Make também consegue chamar a API por um passo de requisição HTTP, sem servidor próprio.
Usar com um assistente de IA
A mesma chave de API conecta o Konversia a um assistente como o Claude (veja MCP: usar o Konversia por uma IA). Dá para pedir:
- "Quais horários a gente tem livre para Corte na quinta-feira?"
- "Agenda um Corte para a Maria, 5511977770000, amanhã às 14h, e avisa ela pelo WhatsApp."
- "Quem está agendado para hoje e ainda não confirmou?"
- "Remarca o agendamento da Maria para sexta às 10h e cancela o do João, que avisou que não vem."
A IA vê os serviços, consulta horários livres, lista e mostra agendamentos, cria, remarca, cancela e confirma. Toda ação que muda a agenda pede a sua aprovação antes de rodar. Para só consultar, crie uma chave apenas com a permissão "Agenda: ler serviços, horários e agendamentos".
Reagir dentro do Konversia
Para mandar uma mensagem ou mover o cliente no CRM quando um agendamento chega por integração, você não precisa de ferramenta de fora: use um workflow com o disparo Evento da agenda, evento Agendamento criado, origem Pela API (veja Evento da agenda).