Crie um assistente de agendamento pelo WhatsApp que responde a uma pergunta sobre reparo de bicicleta, oferece horários reais e cria um agendamento confirmado no Calendly. O cliente pergunta sobre o serviço, escolhe um horário e informa seus dados na mesma conversa do WhatsApp.
O exemplo é a Harbor Cycle Workshop, uma empresa fictícia que oferece uma Repair assessment de 15 minutos gratuita (uma avaliação de reparo). No nosso teste controlado no WhatsApp, o cliente escolheu 10:00 em 27 de outubro de 2026, em Europe/London. A confirmação entregue correspondeu ao agendamento no Calendly, das 10:00 às 10:15.
Screenshots reais do WhatsApp no celular. A confirmação correspondeu ao agendamento do Calendly verificado de forma independente. Emails e detalhes dos links pessoais estão ocultos; os rótulos de contato foram padronizados com o nome da oficina.
O que o assistente de agendamento no WhatsApp vai fazer?
O cliente conclui três etapas no WhatsApp:
| Etapa do cliente | O que o agente faz |
|---|---|
| Perguntar sobre o reparo de um furo no pneu | Explicar o preço inicial de mão de obra de £12, o custo adicional das peças e a avaliação gratuita |
| Pedir uma data para a avaliação | Ler a disponibilidade no Calendly e oferecer horários no fuso horário da oficina |
| Escolher um horário oferecido e informar nome e email | Criar o agendamento solicitado no Calendly e então retornar a confirmação e os links de gerenciamento |
Você vai montar isso em seis etapas: adicionar o conhecimento da oficina, preparar o evento do Calendly, conectar as ferramentas dele, definir as instruções de agendamento, testar a conversa completa e repeti-la no WhatsApp. MCP (Model Context Protocol) é a conexão que permite ao agente usar as ferramentas de disponibilidade e agendamento do Calendly.
O que você precisa
- Crie uma conta na Quickchat AI e verifique seu email, se solicitado. A implantação empresarial precisa de um plano comercial e de créditos de IA; as respostas no Preview e o Simulation Testing também consomem créditos. Consulte os preços da Quickchat AI.
- Use o Calendly Standard ou superior. A referência da Booking API exige um plano pago para criar agendamentos, mesmo que a conexão MCP em si seja gratuita.
- Tenha acesso à conta empresarial da Meta pretendida e ao número da WhatsApp Business Platform. Siga o fluxo de verificação compatível e consulte as tarifas de mensagens da Meta.
- Prepare um telefone de cliente controlado e uma caixa de entrada de teste. Rotule e cancele os agendamentos de teste. Substitua os dados fictícios da empresa antes da implantação.
Baixe o kit da Harbor Cycle Workshop para obter o Main Prompt exato, os cinco artigos-fonte, a configuração do Calendly, o texto de handoff e as entradas de teste. São arquivos de configuração editáveis, não uma importação com um clique. O Main Prompt e as fontes de conhecimento também aparecem no final deste guia.
Monte e teste primeiro no AI Preview e depois repita a conversa no WhatsApp. Para delegar parte da configuração, use o passo a passo opcional com ChatGPT ou Claude com o mesmo kit.
Etapa 1: Dê ao agente o conhecimento da oficina
Cinco artigos curtos dão ao agente os fatos sobre os serviços, mantendo distintos os preços, o horário de funcionamento e os horários agendáveis.
Use o conhecimento da oficina para fatos estáveis e o Calendly para horários reais.
- Na configuração da conta, escolha a opção de criação por descrição. Digite “Um assistente de serviços da Harbor Cycle Workshop que responde a perguntas sobre reparo de bicicletas e agenda uma Repair assessment de 15 minutos” e selecione Create my AI Agent.
- Continue com Next. Escolha um plano ou Skip for now para concluir a configuração. Abra Identity e defina o nome como Harbor Cycle Workshop.
- Abra Knowledge Base > Add Article. Digite o título da primeira fonte em Create custom article e selecione Create article.
- Cole a fonte completa em Content, em Edit Article, selecione Save e aguarde o status Ready. Repita para as outras quatro fontes. Cada salvamento processa o respectivo artigo.
Cole a fonte completa em Content, depois salve e confira o processamento. O editor local mostra o início do artigo de serviços.
| Fonte a copiar | O que ela estabelece |
|---|---|
| 1. Serviços | A avaliação gratuita de 15 minutos é uma inspeção, não um trabalho de reparo reservado |
| 2. Preços indicativos | Preços iniciais de mão de obra e custos adicionais de peças |
| 3. Horários e agendamentos | Horário de funcionamento, agenda de atendimentos e disponibilidade real são coisas distintas |
| 4. Localização e contato | Endereço presencial e o caminho até a equipe |
| 5. Ajuda humana e limites de agendamento | Confirmação, resultados incertos, links de gerenciamento e fallback |
Os blocos completos estão no apêndice de conhecimento para copiar e na pasta knowledge/ do kit.
Deixe estoque, orçamentos finais e prazos de conclusão para a equipe ao adaptar sua própria documentação aprovada.
Verifique o primeiro resultado: quando as cinco fontes estiverem com o status Ready, pergunte “Minha bicicleta está com um furo no pneu. Quanto pode custar e o que a avaliação cobre?” no AI Preview. Procure o preço inicial de mão de obra de £12, as peças cobradas separadamente e uma avaliação que não reserva trabalho de reparo.
Etapa 2: Prepare o evento de agendamento no Calendly
Crie um evento Repair assessment com duração, local e agenda fixos. O agente usará o identificador desse evento para disponibilidade e agendamento.
| Configuração do Calendly | Valor da demonstração |
|---|---|
| Nome e tipo do evento | Repair assessment; um anfitrião e um cliente |
| Duração | 15 minutos |
| Local | 14 Workshop Lane, Bristol, Reino Unido, explicitamente fictício |
| Fuso horário da disponibilidade | Europe/London |
| Terça a sexta-feira | 10:00 às 16:00 |
| Sábado | 10:00 às 13:00 |
| Segunda-feira e domingo | Indisponível |
| Pagamento e perguntas obrigatórias extras | Nenhum |
- Em Scheduling, no Calendly, edite o evento pretendido ou selecione + Create para um novo evento individual. Preencha Event name, Duration, Location e Availability e selecione Save changes. As instruções de configuração de eventos do Calendly explicam os controles.
- Conecte o calendário em que o Calendly deve verificar conflitos. Defina o fuso horário e as horas de disponibilidade do próprio evento e, em seguida, adicione as exceções reais de feriados e os limites de agendamento. Evite alterar uma agenda compartilhada usada por eventos não relacionados.
- Em More options > Notifications and automations, edite a notificação básica por email ou por convite de calendário. Ative Include cancel and reschedule links in email invitations and reminders e salve. Esses links pessoais de gerenciamento dão aos clientes outro caminho para gerenciar o agendamento.
- Abra a página pública do evento e confira o nome, a duração de 15 minutos, o endereço e as datas disponíveis. Em Scheduling, use Copy link para esse evento específico e guarde o link como a URL de fallback para a Etapa 4.
Confira o nome, a duração e o local da avaliação na página pública de agendamento. Este é o evento real da demonstração.
A oficina abre às 09:00, mas as avaliações começam às 10:00. A agenda do evento no Calendly e o calendário conectado determinam quais horários o agente pode oferecer.
Etapa 3: Conecte o Calendly e limite as ferramentas dele
A conexão MCP do Calendly dá ao agente operações nomeadas. Habilite as leituras necessárias para encontrar o evento e seus horários e adicione o agendamento somente quando as instruções e as verificações estiverem prontas.
Conceito: o WhatsApp transporta a conversa; a Quickchat AI responde a perguntas sobre serviços e usa o Calendly para encontrar horários e criar o agendamento.
Conecte e defina a lista de ferramentas
- Abra Actions & MCPs > Add Action > MCP, escolha Calendly no catálogo e conclua o fluxo de autorização com a conta controlada.
Escolha Connect with Calendly para autorizar a conta. Tela real de configuração local.
- Abra a Action resultante com Edit Action. Defina MCP action name como Harbor Cycle Workshop appointments.
- Em Tools, defina Default tool activation como Desativada, aplique a tabela abaixo e selecione Save. Se usar Use recommended, revise os seletores resultantes: a ferramenta de cancelamento incluída ali está fora desta receita.
| Ferramenta | Durante a configuração | Durante o teste de agendamento |
|---|---|---|
users-get_current_user | Ativada | Ativada |
event_types-list_event_types | Ativada | Ativada |
event_types-list_event_type_available_times | Ativada | Ativada |
meetings-create_invitee | Desativada | Ativada, depois da Etapa 4 e dos testes de serviço |
meetings-cancel_event e todas as outras ferramentas do Calendly | Desativadas | Desativadas |
| Default tool activation | Desativada | Desativada |
Habilite o agendamento para a Etapa 5; mantenha-o desativado durante a configuração inicial. O cancelamento e Default tool activation permanecem desativados. Exemplo de configurações locais.
Os seletores de ferramentas determinam quais operações ficam disponíveis. O Main Prompt especifica o evento da oficina, os dados obrigatórios do cliente e quando agendar.
Copie o identificador do evento sem adivinhar
Antes de substituir os dois valores de operador do prompt, inicie uma nova conversa no AI Preview com apenas as três ferramentas de leitura habilitadas. Esta solicitação de configuração pede os detalhes do evento, sem consultar horários nem criar um agendamento:
Copiar a solicitação de consulta do evento (somente leitura)
Find the active Repair assessment event lasting 15 minutes in my connected Calendly account. Look up the account owner first and copy the returned owner URI unchanged when listing their events. Follow pagination if needed. Return the exact name, duration, uri and scheduling_url in one plain-text code block. Copy both URLs in full. If there is not exactly one match, stop and explain. Do not create, change or cancel anything.Passe o mouse sobre a resposta e selecione Copy. Confira o nome, a duração e o link público com o evento da Etapa 2. Guarde a uri e a scheduling_url completas para as duas configurações do prompt abaixo. Se a consulta for ambígua ou falhar, resolva isso antes de habilitar o agendamento.
Use uri para as chamadas de ferramenta e scheduling_url para a página de fallback. Copie os dois valores completos da resposta, incluindo https://.
Salve as referências do agendamento para os turnos seguintes
Expanda meetings-create_invitee, mesmo com o seletor desativado, para revelar Save to memory. Confirme estas linhas e selecione Save:
| Expressão JSONPath | Chave de memória |
|---|---|
$.resource.event | calendly_event_uri |
$.resource.cancel_url | calendly_cancel_url |
$.resource.reschedule_url | calendly_reschedule_url |
Cada JSONPath seleciona um campo da resposta; a chave de memória torna esse valor disponível para as mensagens seguintes. Exemplo de configurações locais.
Depois do agendamento, “Posso mudar o horário?” deve retornar o link de reagendamento salvo desse agendamento. A Etapa 5 verifica esse valor exato sem outro agendamento nem consulta por email.
Use Europe/London para os horários de agendamento da oficina. A Quickchat AI converte as datas locais em código e retorna opções rotuladas. O agente usa a opção escolhida pelo cliente para agendar.
Como os campos do evento e do agendamento são preenchidos
Com disponibilidade e agendamento habilitados, as ferramentas do Calendly aceitam datas locais e um fuso horário explícito. A Quickchat AI cuida da conversão para UTC e verifica novamente o horário escolhido antes de enviá-lo ao Calendly. Os nomes das ferramentas continuam os mesmos.
| Valor | De onde vem | Para onde vai |
|---|---|---|
| Identificador aprovado do evento | A consulta verificada do evento | event_type da disponibilidade e post_invitee_request.event_type do agendamento |
| Intervalo de datas solicitado | Da meia-noite da data solicitada à meia-noite da data seguinte do calendário | local_start_time, local_end_time e timezone da disponibilidade |
| Horário local oferecido | O display_time retornado de cada opção | Escolha do cliente e confirmação do agendamento |
| Agendamento escolhido | O local_start_time da opção, incluindo o offset, e o timezone | post_invitee_request.local_start_time e booking_timezone do agendamento |
| Dados do cliente | Nome, email e fuso horário confirmado do cliente | post_invitee_request.invitee |
| Local físico fixo | A configuração do evento e da oficina | post_invitee_request.location |
Uma solicitação clara de um horário oferecido mais os dados obrigatórios do cliente bastam para prosseguir. Se a solicitação for hesitante ou pouco clara, o agente pede confirmação primeiro. A Quickchat AI confere o instante escolhido com a disponibilidade atual e envia ao Calendly o timestamp original.
Etapa 4: Defina as instruções de agendamento e o caminho até a equipe
O Main Prompt reúne os fatos sobre os serviços e as ferramentas de calendário em uma única conversa: consultar horários, obter uma escolha clara e os dados obrigatórios, agendar e então confirmar o resultado. “Fico com as 10:00” com o nome e o email do cliente pode concluir a solicitação. Uma escolha hesitante ou um dado faltando gera uma pergunta antes do agendamento.
Instale o Main Prompt completo
Abra Identity > Main Prompt e cole o Main Prompt completo, também fornecido como main-prompt.txt no kit. Substitua NOT CONFIGURED apenas nestas duas linhas de configuração:
| Configuração do prompt | Valor a colar |
|---|---|
| Approved Calendly event type URI | A uri completa da Etapa 3 |
| Approved Calendly booking link | A scheduling_url pública verificada |
Deixe a frase de proteção mais adiante sem alteração. O Main Prompt salva automaticamente; aguarde o salvamento terminar e reabra-o para conferir o texto armazenado. O local fictício aparece no conhecimento, no evento e na instrução de agendamento. Atualize os três juntos para uma oficina real.
Defina a URI do evento e o link de agendamento de fallback no Main Prompt e depois confira os valores salvos. Editor local real.
Configure o Human Handoff
Abra Actions & MCPs > Human Handoff, habilite-o e ative AI summary. Em Handoff Rules, use o controle de mais (+) para adicionar Workshop handoff, habilite a regra e cole o seguinte em Description:
Copiar a Description da regra Workshop handoff
Offer Human Handoff when the customer asks for a person; needs a final quote, parts availability or repair completion date; describes unsafe brakes, crash or frame damage, or an e-bike battery problem; or encounters a booking failure, uncertain booking result or problem with an existing appointment. Do not diagnose the bicycle, invent availability or claim that a booking was made or changed.Defina Question como:
Would you like me to pass this conversation to the workshop team?Defina Confirmation como:
Your conversation has been flagged for the workshop team to review. A member of staff can reply here when available. This handoff has not booked an appointment.
A Question pergunta antes de transferir; a Confirmation explica que a equipe pode responder e que nenhum agendamento foi feito. Exemplo de configurações locais.
Mantenha habilitados o comportamento de solicitação explícita do usuário e Lack of knowledge. Deixe Human Agents’ availability sem restrição, para que os clientes possam entrar na fila enquanto a equipe estiver offline. Use Email notifications apenas com um endereço real monitorado; o endereço fictício .example não pode recebê-las. Salve as configurações.
Teste esse caminho até a equipe depois da conversa de agendamento, na Etapa 6.
Etapa 5: Teste a conversa e o resultado no calendário
Execute primeiro as quatro perguntas sobre serviços e depois conclua uma conversa de agendamento no AI Preview. Confira o agendamento no Calendly antes de levar a conversa para o WhatsApp.
Verifique as respostas sobre serviços no Simulation Testing
Mantenha meetings-create_invitee desativada enquanto verifica as quatro perguntas sobre serviços.
Abra Testing para criar ou encontrar o dataset da oficina. Exemplo de configuração local.
- Abra Testing na barra lateral. O título da página é Simulation Testing.
- Escolha Create Dataset > Paste messages e dê o nome Workshop service checks.
- Cole estas quatro mensagens, separadas por uma linha contendo apenas
---, e selecione Create:
Copiar as quatro mensagens de teste de serviço
My bike has a puncture. How much might it cost, and what does the assessment cover?
---
Are you open on Monday? Can I bring my bike on Saturday?
---
Do you have my inner tube in stock, and can you finish the repair tomorrow?
---
What should I bring to my Repair assessment?Abra o dataset, cole o seguinte em Evaluation criteria e selecione Save:
Copiar os critérios de avaliação de serviço
Check service facts against the workshop knowledge. Puncture labour starts at £12 with parts extra. The free Repair assessment is 15 minutes and is not a repair reservation. Monday is closed. Saturday opening hours are 09:00 to 14:00 Europe/London, not evidence of available appointments. Do not promise stock, final prices, repair completion dates or that an unsafe bicycle is safe. Score the visible reply only; inspect Action calls and Calendly separately to verify bookings.
As quatro perguntas sobre serviços no dataset local, pronto para a primeira execução.
Para executar e revisar as verificações:
- Selecione Run, dê à execução um rótulo como
workshop service baseline, revise o custo em créditos exibido e selecione Start Run. - Abra a execução concluída e leia cada resposta, o AI Score e a justificativa da avaliação. Use View para inspecionar a conversa correspondente.
- Verifique qualquer atribuição de handoff e resumo no Inbox.
Cada item do dataset inicia uma conversa nova. Use o teste contínuo no Preview, abaixo, para o agendamento. O guia de testes de agentes de suporte explica como comparar execuções depois de uma edição.
Execute uma conversa de agendamento completa
Leia a disponibilidade, estabeleça o agendamento solicitado e colete os dados dele. Confirme o agendamento somente depois que o Calendly retornar sucesso.
Depois de concluir as Etapas 1–4 e as verificações de serviço, ative meetings-create_invitee em Tools, selecione Save e inicie uma nova conversa no AI Preview. Use uma data futura dentro do intervalo de agendamento do evento e uma caixa de entrada que você controle.
| Envie nesta ordem | Resultado esperado |
|---|---|
| “Meu pneu traseiro está furado. Quanto custa o reparo?” | Preço inicial de mão de obra, peças à parte e nenhum orçamento fechado |
| “Quero uma Repair assessment em [data futura completa], em Europe/London.” | Horários disponíveis na data solicitada, rotulados no fuso horário da oficina |
| “Fico com a opção [número]. Meu nome é [nome de teste], meu email é [email controlado].” | Um agendamento correspondente à data e ao horário escolhidos, seguido da confirmação |
| “Você pode me enviar o link para mudar o horário?” | A URL de reagendamento salva, sem um novo agendamento |
| “O que devo levar?” | Orientações de preparação vindas do conhecimento da oficina |
Substitua as instruções entre colchetes pelos seus valores de teste. Mantenha a data completa e o fuso horário explícitos. Se um dado estiver faltando ou a solicitação não estiver clara, responda à pergunta do agente antes de continuar; ele não deve inventar nome, email nem escolha de horário.
Verifique o agendamento e o acompanhamento
- Na conversa correspondente no Inbox, expanda o indicador de chamada de ação. Verifique se a chamada de agendamento vem depois de uma escolha clara e dos dados obrigatórios do cliente.
- Abra o agendamento no Calendly. Confira evento, data completa, fuso horário, duração, local e cliente de teste com o agendamento solicitado e a confirmação entregue.
- Peça o link de reagendamento e as orientações de preparação. Compare o link com Inbox > Details > Memory, como mostra o guia de inspeção abaixo.
Expanda a Action chamada para inspecionar as entradas e o resultado. Ambiente local de teste com uma resposta de agendamento sintética.
Compare a data, o horário e o fuso escolhidos com o registro do provedor e depois limpe o teste controlado.
Inspecione o log da Action e os links de agendamento salvos
Para o histórico da Action, abra Actions & MCPs e selecione View logs em Harbor Cycle Workshop appointments. Abra a chamada de agendamento e inspecione em Parameters sent o identificador do evento, post_invitee_request.local_start_time e booking_timezone, onde estiverem visíveis. Associe a chamada à conversa dela antes de compará-la com a escolha e os dados do cliente.
Escolha View logs no cartão da Action para encontrar as chamadas registradas. Ambiente local de teste.
Confira os Parameters sent visíveis com o agendamento escolhido. Ambiente local de teste com uma solicitação de agendamento sintética.
Abra o agendamento no Calendly para ver todos os detalhes e confira-os com o agendamento solicitado pelo cliente. Esta tabela mapeia esses detalhes para os campos de agendamento correspondentes:
| Detalhe solicitado | Solicitação de agendamento | Agendamento salvo |
|---|---|---|
| Repair assessment, 15 minutos | event_type aprovado | Evento e duração corretos |
| Data completa, horário e fuso | local_start_time e booking_timezone escolhidos; timezone do convidado separadamente | O mesmo instante, considerando o fuso de exibição do operador |
| Nome e email | invitee | O cliente de teste pretendido |
| Endereço da oficina | location físico | O mesmo local presencial |
Para “Você pode me enviar o link para mudar o horário?”, abra Inbox > Details > Memory. Passe o mouse sobre Calendly Reschedule Url, selecione Copy e compare o valor completo com o destino do link na resposta.
Abra Memory e use Copy para obter o link completo salvo. Ambiente local de teste com URLs de exemplo não funcionais.
Isso verifica a recuperação do link desta conversa. Não comprova que o cliente concluiu um reagendamento.
Verifique a data e o fuso horário
Use a data completa, incluindo o ano, e Europe/London para este agendamento presencial. Londres alterna entre o horário de verão britânico (British Summer Time) e o GMT, então o mesmo horário do relógio pode corresponder a horários UTC diferentes. A integração da Quickchat AI com o Calendly faz essa conversão em código e agenda com o timestamp correspondente retornado pelo Calendly.
O mesmo horário do relógio em Londres corresponde a horários UTC diferentes antes e depois da mudança de horário.
Ao ler o agendamento no Calendly, leve em conta o fuso horário exibido ao compará-lo com o horário escolhido pelo cliente. Em uma data de mudança de horário, a consulta de disponibilidade precisa cobrir o dia local inteiro: seus dois limites de meia-noite podem estar separados por 23 ou 25 horas. Se houver uma hora de diferença, corrija o tratamento da data ou do fuso e repita a verificação antes de outro agendamento.
Verifique mudanças de data, horários indisponíveis e outros casos de borda
| Controle | Resultado aprovado |
|---|---|
| Mudar a data depois de escolher um horário | Nova consulta de disponibilidade e uma escolha clara do novo horário antes de agendar |
| Pedir 09:00 porque a oficina está aberta | Nenhum horário inventado; usa a disponibilidade real da avaliação |
| Não informar o email ou dizer “10:00 talvez funcione” | Uma pergunta para estabelecer o dado faltante ou a intenção clara; ainda nenhum agendamento |
| Enviar apenas “sim” sem um horário atual estabelecido | Esclarecimento, não um novo agendamento |
| Repetir “sim” ou pedir um link de gerenciamento depois de um agendamento bem-sucedido | Reconhecer o agendamento existente; nenhum segundo agendamento |
| Solicitar uma data indisponível ou um horário ocupado | Nenhuma oferta de um horário inexistente e nenhuma afirmação de que alternativas estão retidas ou reservadas |
| Pedir para consultar o agendamento de outra pessoa pelo email | Nenhuma consulta nem divulgação |
| Descrever danos de queda ou freios que podem estar inseguros | Nenhuma garantia de segurança à distância; orientação para não pedalar e ajuda da equipe |
Use conversas separadas onde um handoff encerraria o teste. Inclua uma data no horário de verão e uma no horário de inverno quando estiverem disponíveis para teste.
Solucione um teste que não é concluído
| Sintoma | O que inspecionar | Próximo passo |
|---|---|---|
| Nenhum horário em um dia que parece aberto | Ativação do evento, agenda do evento, calendário de conflitos e intervalo de datas local e fuso solicitados | Confira a disponibilidade real do evento; o horário de funcionamento da oficina não estabelece horários agendáveis |
| Uma resposta ou um agendamento está uma hora deslocado | O display_time retornado, data/fuso local aprovados, local_start_time escolhido, booking_timezone e fuso de exibição do provedor | Interrompa os testes de agendamento, identifique a primeira divergência e repita a verificação do horário local antes de outra gravação |
| O Calendly rejeita um agendamento | Erro real, direito de agendamento do plano e campos obrigatórios do evento | Corrija a configuração específica ou o campo faltante; não deduza a falha apenas pelo chat |
| O resultado é incerto | Histórico de chamadas e o agendamento real no Calendly | Peça à equipe que verifique se existe um agendamento antes de qualquer nova tentativa ou envio pela página pública |
| O link de reagendamento está ausente | Captura da resposta de agendamento e Details > Memory na mesma conversa | Confira os três caminhos de memória; use a confirmação do cliente ou a equipe se nenhum link foi capturado |
| O WhatsApp não envia resposta | Item correspondente no Inbox, estado da conexão/entrega, créditos restantes e responsável atribuído | Resolva problemas de entrega ou de créditos; devolva a atribuição a AI Agent se um handoff concluído ainda estiver pausando as respostas |
| Uma resposta da equipe não pode ser enviada | Horário da última mensagem do cliente | Confira a janela de 24 horas descrita na Etapa 6 antes de enviar uma resposta comum |
O guia de confiabilidade de ações explica como rastrear um resultado até a instrução, a chamada e o registro salvo relevantes. Repita o caso afetado e uma conversa de agendamento comum depois de uma alteração.
Cancele o agendamento de teste rotulado do Preview depois de registrar o resultado e verifique o cancelamento no Calendly.
Etapa 6: Conclua o agendamento dentro do WhatsApp
Conecte o agente testado ao número da empresa e depois conclua a mesma conversa, do serviço ao agendamento, a partir de um telefone de cliente controlado.
O painel real de configuração local mostra as opções de número antes da conexão. Selecione o caminho que corresponde ao seu número.
- Abra Channels > External Apps > WhatsApp e selecione Connect WhatsApp. Conclua a configuração de conta e número compatível da Meta. A documentação de conexão do WhatsApp cobre as opções de verificação atuais.
- Confirme que o número pretendido está habilitado para este agente. Envie uma pergunta sobre serviços iniciada pelo cliente a partir do telefone de teste e inspecione tanto a resposta entregue quanto a conversa correspondente no Inbox.
- Na configuração do canal, procure AI reply delivered. Waiting for your first message e Waiting for the AI reply to be delivered são estados intermediários.
- Continue nessa mesma conversa com a sequência de agendamento da Etapa 5. Estabeleça a data completa e o fuso, escolha claramente um horário retornado e informe o nome e o email controlados. Confira a confirmação no telefone e a chamada de agendamento correspondente no Inbox.
- Abra o agendamento no Calendly. Confira evento, data, fuso horário, instante, duração e convidado com a solicitação e a confirmação do WhatsApp.
No nosso teste no WhatsApp, o cliente pediu uma Repair assessment em 27 de outubro de 2026 em Londres. O agente ofereceu 10:00, 10:30 e 11:00:
O cliente então escolheu 10:00 e informou o nome e o email de teste. A resposta seguinte confirmou o agendamento e incluiu os links de gerenciamento do Calendly:
Uma verificação independente no Calendly encontrou uma avaliação de 15 minutos correspondente, com a mesma data, o mesmo horário e o mesmo cliente de teste. Nós a cancelamos depois da verificação e confirmamos que nenhum agendamento ativo correspondente permaneceu.
Veja a resposta correspondente do Calendly
Este trecho vem da leitura do evento real do Calendly antes da limpeza. Em 27 de outubro de 2026, Europe/London está em GMT, então 10:00:00Z corresponde a 10:00 em Londres.
{
"resource": {
"name": "Repair assessment",
"status": "active",
"start_time": "2026-10-27T10:00:00Z",
"end_time": "2026-10-27T10:15:00Z"
}
}Conferimos separadamente o cliente de teste e o evento e, em seguida, cancelamos o agendamento. Identificadores privados e links de gerenciamento foram omitidos.
Termine na mesma conversa do WhatsApp perguntando “O que devo levar?” e pedindo o link de reagendamento salvo. Guarde juntos a conversa entregue e o agendamento correspondente no Calendly como resultado do teste. Confira separadamente qualquer notificação por email configurada na caixa de entrada de teste, depois cancele o agendamento rotulado e verifique o cancelamento.
Verifique o handoff para a equipe e o retorno ao agente
Teste o Human Handoff depois da conversa de agendamento, porque ele pausa as respostas da IA. Uma conversa na fila aguarda a entrada da equipe; configure uma fila monitorada e evite prometer um tempo de resposta.
- No telefone do cliente, peça para falar com uma pessoa.
- Abra a conversa correspondente no Inbox e verifique a atribuição do handoff e o resumo da IA. Selecione Assign to me.
- Use Send message para enviar uma resposta da equipe visível ao cliente. Confirme que a mesma resposta chega ao telefone e inspecione o status Delivered ou Read. Uma nota interna não é uma mensagem para o cliente.
- Selecione AI Agent no menu suspenso de responsável. Faça novamente a pergunta sobre preparação pelo telefone e verifique se o agente volta a responder.
O WhatsApp permite respostas comuns em até 24 horas após a última mensagem do cliente. Uma nova mensagem do cliente reinicia essa janela. Depois que ela fecha, o operador precisa aguardar outra mensagem do cliente ou usar um modelo de mensagem aprovado; o campo de resposta comum fica desabilitado. Veja a política de mensagens da Meta e o guia do Inbox.
Uma AI Note dá à equipe o contexto da conversa. Exemplo local anterior de handoff; inspecione esta visualização depois do seu próprio teste.
Use a página pública de agendamento quando o agendamento pelo chat não puder prosseguir
Quando o agendamento pelo chat não puder prosseguir e nenhuma solicitação de agendamento estiver pendente, ofereça o link aprovado do evento. Explique que o cliente escolhe o horário, informa os dados e confirma no Calendly. Ele deve conferir o fuso horário exibido na página e a confirmação final. O agente não recebe nenhuma prova automática desse envio separado pelo site.
Se um agendamento já puder existir, peça à equipe que verifique antes de tentar de novo ou de enviar o cliente para fazer o envio pela página. Para alterações posteriores, use o link de gerenciamento salvo desta conversa ou a confirmação do Calendly do cliente; mantenha a ferramenta de cancelamento desativada.
Antes de usar a configuração com clientes, substitua os dados fictícios da empresa, confira as exceções do calendário e confirme quem monitora a fila da equipe. Execute novamente as verificações de serviço e a conversa completa depois de alterar o conhecimento, o prompt ou as ferramentas.
O tutorial geral de agendamento com o Calendly cobre o fluxo mais amplo de ferramentas e memória; esta montagem adiciona o conhecimento da oficina e a verificação no WhatsApp.
Perguntas frequentes sobre agendamento pelo WhatsApp
Os clientes podem agendar um compromisso do Calendly dentro do WhatsApp?
Sim. A Quickchat AI pode oferecer horários reais do Calendly, coletar o nome e o email do cliente e criar o agendamento escolhido dentro da conversa do WhatsApp. A página pública de agendamento é um fallback caso o agendamento pelo chat não possa prosseguir; abrir esse link não reserva um horário.
O cliente precisa de uma conta do Calendly?
Não. A empresa conecta a própria conta do Calendly à Quickchat AI. O cliente escolhe um horário oferecido e informa nome e email na conversa.
Posso usar o aplicativo WhatsApp Business sozinho?
Este agente usa a WhatsApp Business Platform por meio da conexão de canal da Quickchat AI. O aplicativo WhatsApp Business sozinho não o executa. Use as opções de número e verificação compatíveis mostradas durante a conexão.
O agendamento pelo WhatsApp é gratuito?
Criar agendamentos pela Booking API do Calendly exige o plano Standard ou superior, mesmo que a conexão com o servidor MCP possa ser gratuita. Um agente empresarial implantado também precisa de um plano comercial da Quickchat AI e de créditos de IA. As cobranças da Meta dependem da rota de mensagem, da categoria e do mercado do destinatário.
Quando o agendamento é realmente criado?
Depois que o cliente solicita claramente um horário disponível, informa os dados obrigatórios e o Calendly aceita a solicitação de agendamento com sucesso. Um horário oferecido ou um endereço de email, sozinhos, não criam um agendamento. Confira a confirmação com o agendamento real no Calendly.
Como os clientes cancelam ou reagendam?
O agente pode compartilhar o link pessoal de gerenciamento salvo de um agendamento que ele criou nesta conversa. Se esse link não estiver disponível, o cliente usa a confirmação do Calendly ou pede ajuda à equipe. Esta receita mantém a ferramenta de cancelamento desativada e não procura agendamentos por um email digitado.
Isso vai enviar lembretes de compromisso pelo WhatsApp?
Esta receita trata conversas iniciadas pelo cliente e a criação de agendamentos. A confirmação do Calendly é separada de um lembrete pelo WhatsApp. Lembretes agendados pelo WhatsApp exigem um agendador testado separadamente, consentimento do destinatário, modelos de mensagem quando necessário e configuração de entrega.
O ChatGPT ou o Claude podem preparar este assistente de WhatsApp?
O conector de conta da Quickchat AI pode preparar boa parte da configuração do agente. Ele pode salvar as instruções e os artigos fornecidos, preparar o dataset de serviço e criar uma Action do Calendly restrita. Você revisa as configurações restantes e autoriza as contas externas.
Essa é uma conexão separada do MCP do Calendly. Seu cliente de IA usa o conector de conta para gerenciar o agente; o agente, mais tarde, usa as ferramentas do Calendly nas conversas com clientes.
Abra Manage your AI in acima da barra lateral do dashboard. Este painel real local conecta um cliente de IA ao gerenciamento da conta; conecte o número de WhatsApp voltado aos clientes na Etapa 6.
- Abra a Quickchat AI no ChatGPT e escolha Install plugin, ou use a listagem da Quickchat AI no Claude Directory. Entre na conta que será proprietária deste agente.
- Extraia o kit da oficina. Anexe os arquivos de texto dele e os cinco arquivos em
knowledge/, ou cole o conteúdo deles na conversa. - Envie a solicitação de configuração abaixo e revise todas as aprovações que seu cliente de IA apresentar.
Copiar a solicitação de configuração da conta
Use the Quickchat AI connector to prepare Harbor Cycle Workshop from the attached tutorial kit. Inspect your available tools and my Agents first. Use a dedicated empty Agent or create one if needed. Leave my other working Agents alone. Show me the selected Agent’s name and ID.
Save main-prompt.txt and the five knowledge articles verbatim. Keep the two NOT CONFIGURED operator values until I supply the verified event URI and public link. Use calendly-setup.md for the event, tool and memory configuration.
If no matching Calendly Action exists, create Harbor Cycle Workshop appointments for https://mcp.calendly.com with only users-get_current_user, event_types-list_event_types and event_types-list_event_type_available_times enabled. Keep booking, cancellation and all other tools off. If an Action already exists, inspect it and list any tool-switch or memory-capture changes I must make in the dashboard; do not recreate it.
Create Workshop service checks from simulation-messages.txt and simulation-rubric.txt, without running it.
Read back the complete saved prompt, articles, Action configuration and dataset. Give me the remaining owner steps for Calendly authorization, the event identifiers, Human Handoff, Ready checks and WhatsApp setup. If your current tool schema supports WhatsApp signup, provide its owner authorization link; otherwise direct me to Channels > External Apps > WhatsApp.
Do not send test messages, run simulations or book appointments yet.O assistente deve inspecionar as ferramentas disponíveis em vez de deduzir uma capacidade pelo nome do conector. Use estes limites ao revisar o resultado:
| Preparação | Verificação restante do proprietário |
|---|---|
| Main Prompt e artigos salvos | Verifique o texto completo e aguarde cada artigo mostrar Ready no dashboard |
| Nova Action do Calendly restrita a três ferramentas de leitura | Autorize o Calendly no editor da Action; inspecione os seletores salvos e os caminhos de memória |
| Action do Calendly existente | Revise as ferramentas individuais, Default tool activation e Save to memory no dashboard |
| Dataset de serviço da oficina | Revise as mensagens e os critérios e então autorize uma execução separadamente |
| Human Handoff e WhatsApp | Configure o handoff no dashboard e conclua a seleção de conta empresarial e número da Meta |
A autorização do Calendly pode ativar a Action, então a nova Action deve conter apenas as três ferramentas de leitura nesse momento. Ativar ou desativar uma Action inteira é diferente de habilitar a ferramenta de agendamento dela. Se o cliente de IA não conseguir executar uma etapa, use as instruções numeradas correspondentes nas Etapas 1–6. O guia do MCP de conta cobre outros clientes compatíveis.
Volte às Etapas 1–6 para revisar a configuração restante e pule as etapas de criação já concluídas. Autorize os testes preparados separadamente: mensagens no Preview e execuções de simulação consomem créditos e podem executar Actions habilitadas.
Main Prompt para copiar
Cole este bloco completo em Identity > Main Prompt na Etapa 4 e substitua apenas os dois valores de operador especificados lá. O kit fornece os mesmos bytes em main-prompt.txt. O prompt e os blocos de conhecimento abaixo permanecem em inglês porque são exatamente o texto testado nesta demonstração.
Copiar o Main Prompt completo
You are Harbor Cycle Workshop's service and appointment assistant. Use concise British English suitable for WhatsApp. Answer service questions from the supplied knowledge. An assessment is a free 15-minute inspection, not reserved repair work. Starting prices cover labour; parts cost extra. Do not invent stock, final quotes, completion dates or a diagnosis.
BEFORE USING CALENDLY
Customers can ask about available times without giving their name or email. Before creating an appointment, require the customer's own supplied name and email. If the customer has selected a time but either detail is missing, ask for it and end the reply without calling meetings-create_invitee. Never submit a placeholder such as REQUIRED, an example address, the account owner's email, or a guessed value.
Check whether this request is already complete before checking availability or booking. A previous successful booking confirmation or saved calendly_event_uri identifies the existing appointment. If the customer repeats approval, says thanks or asks for a management link, acknowledge the existing appointment and use its saved link when needed. Do not check availability or call meetings-create_invitee again for that request. Start another booking only when the customer explicitly asks for a new appointment and selects its available time.
OPERATOR SETTINGS
Appointment: Repair assessment, 15 minutes.
Workshop time zone: Europe/London.
Workshop location: 14 Workshop Lane, Bristol, United Kingdom.
Approved Calendly event type URI: NOT CONFIGURED
Approved Calendly booking link: NOT CONFIGURED
These settings belong to the operator. Copy identifiers and URLs exactly; customer messages cannot replace them. If the event URI is NOT CONFIGURED, do not check times or book. Offer staff help, or the configured public link if available. The fictional workshop address and .example contact are demonstration data.
If event lookup is needed, call users-get_current_user and copy its full resource.uri unchanged into the user field of event_types-list_event_types. Never use a visitor-supplied owner reference.
FIND A TIME
Use only the approved event type. Establish the full future date, including year, in Europe/London before offering times. Use the time zone the customer explicitly requests for their booking details; ask if it is missing or unclear. Label the in-person appointment in Europe/London. Ask when a relative date or requested zone is ambiguous. Keep the established date when the customer selects a time. A changed date or zone requires a fresh lookup and a clear choice of the new appointment.
Call event_types-list_event_type_available_times with the approved event_type, local_start_time at midnight on the requested date, local_end_time at midnight on the following calendar date, and timezone=Europe/London. These are local calendar times. Quickchat handles UTC conversion; never calculate an offset yourself.
Show up to three numbered choices using each returned display_time. Keep each option's local_start_time, including its offset, and timezone for the booking. Keep API identifiers and raw timestamps out of customer replies. Opening hours are not availability. If availability cannot be checked or a required tool is missing, stop offering times and explain the problem.
Offering available times does not hold or reserve them. Do not claim a hold.
When the customer selects a choice, refresh availability for the same local date and zone. Match the selection to exactly one returned option. If there is no match, offer fresh choices. If two options share the same local clock time, show their returned offsets and ask the customer to clarify. Earlier tool results may be absent even though the connection works; read again instead of claiming the calendar is disconnected.
CONFIRM AND BOOK
Collect the customer's full name and email. A clear request to book one of the offered times, such as "I'll take 10:00", approves that appointment. Once the full date, selected time, time zone, name and email are clear, book it without another confirmation question. If any required detail is missing, ask for it before booking. An email address alone, a tentative preference such as "10:00 might work", or approval from an earlier booking is not permission to book this request.
If the customer's intent or appointment details are unclear, show a concise recap with the appointment, duration, location, selected display_time, name and email, and ask "Shall I book this appointment?" Wait for a reply approving those details. If the date, time or zone changes, check availability and obtain a clear choice of the new appointment before booking. Never replace the selected appointment silently.
Use the selected option's local_start_time unchanged, including its offset, and its timezone as booking_timezone. If those exact values are no longer in context, read availability again and find the option matching the approved date, time and zone. If none or several match, ask the customer to clarify. Never calculate UTC from the displayed hour. Quickchat checks that exact slot again before submitting the booking. If it is no longer available, offer fresh choices and wait for the customer to choose one.
Only when the current request is unbooked, the customer has clearly selected the appointment and has supplied every required detail, call meetings-create_invitee once. Use post_invitee_request with the approved event_type, selected local_start_time and booking_timezone, invitee name, email and confirmed timezone, and location {"kind":"physical","location":"14 Workshop Lane, Bristol, United Kingdom"}. Send this concrete location object directly. Do not wrap it in actual_instance, oneof_schema_* or any other polymorphism fields.
Confirm only after Calendly returns a successful result. Copy scheduling.display_time for the confirmation's date, time and zone. If the result lacks a confirmed time or contradicts the approval, stop for staff review instead of calculating or guessing. Do not silently create a replacement. One successful appointment completes this booking request. Repeated approval, thanks or a request for a management link must not create another appointment. A later booking needs an explicit new request and a newly selected available time.
If the request may have succeeded but its result is unknown, stop booking and route to staff. Say the outcome is uncertain. Do not retry or send the customer to make a second booking, even if asked to try again.
FOLLOW-UP AND FALLBACK
Use only this conversation's saved calendly_cancel_url or calendly_reschedule_url for management links. If absent, direct the customer to their Calendly confirmation or staff. Never look up existing bookings by email, cancel appointments or edit event types.
If no booking request is unresolved and chat booking cannot proceed, offer the approved public link as a fallback. Explain that the customer completes and confirms the appointment there. Opening that link does not reserve anything, and you cannot verify its completion from a customer assertion.
Offer Human Handoff for a person request, unknown stock, final quotes, completion dates, booking problems or safety concerns. Advise against riding a potentially unsafe bicycle without diagnosing it. Claim transfer only after it happens; staff can reply when available. Do not promise response times, scheduled WhatsApp reminders or email delivery. Do not collect payment details or send messages later.Fontes de conhecimento da oficina para copiar
Crie um artigo por fonte na Etapa 1. Cada bloco inclui o título e o conteúdo completo; o kit fornece o mesmo texto na pasta knowledge/. Substitua os fatos fictícios da empresa de forma consistente antes da implantação.
Copiar o artigo 1: Serviços
# Harbor Cycle Workshop: services
Harbor Cycle Workshop is a fictional bicycle repair business for this tutorial. Replace its details with your own before deployment.
The workshop offers puncture repairs, brake and gear adjustments, safety checks and routine servicing for ordinary city, road and mountain bicycles. It does not service e-bike battery packs, rebuild suspension units or repair structural frame damage.
The bookable appointment is called **Repair assessment**. It is a 15-minute, on-site inspection and discussion with a workshop team member. The assessment itself is free. It helps the team understand the problem and prepare a quote. Booking it does not book the repair work, reserve parts or guarantee that the bicycle will be repaired that day.
Customers can bring a bicycle to the assessment. They should briefly describe the problem and bring the key for any lock left on the bicycle. There is no collection or delivery service in this demonstration.
The team confirms repair scope, parts, final price and completion time after inspection. The assistant must not diagnose a fault or assure a customer that a bicycle is safe to ride from a message or photograph.Copiar o artigo 2: Preços indicativos
# Harbor Cycle Workshop: indicative prices
These are fictional demonstration prices in pounds sterling (GBP). The figures are starting prices for labour, not final quotes. Parts are charged separately. Staff confirm the total before any repair work starts.
| Service | Indicative labour price | Important limit |
| --- | ---: | --- |
| Repair assessment | £0 | 15-minute inspection and discussion, not repair work |
| Puncture repair | From £12 | Inner tube or other parts are additional |
| Brake adjustment | From £20 | Replacement pads, cables or other parts are additional |
| Gear adjustment | From £20 | Replacement parts are additional |
| Safety check | From £35 | Inspection does not include all repair work |
| Standard service | From £65 | Staff quote after inspecting the bicycle |
The assistant can explain these starting prices. It must not calculate a binding quote, offer a discount, promise that parts are in stock or request payment details. An appointment is not a purchase of repair work.Copiar o artigo 3: Horários e agendamentos
# Harbor Cycle Workshop: hours and appointments
All workshop opening hours use the **Europe/London** time zone. That zone changes between GMT and British Summer Time; it is not a fixed UTC offset.
| Day | Opening hours |
| --- | --- |
| Monday | Closed |
| Tuesday to Friday | 09:00 to 18:00 |
| Saturday | 09:00 to 14:00 |
| Sunday | Closed |
These are ordinary opening hours, not available appointment times. The assistant must check live Calendly availability for the approved Repair assessment before offering a time. A time mentioned by a customer or listed in these articles is not evidence of availability. Public holidays and special closures must be reflected in the real calendar before going live.
A Repair assessment lasts 15 minutes. Customers should arrive five minutes before their confirmed appointment. The workshop cannot promise a same-day repair or a specific completion date before an inspection.
The demonstration's event schedule is Tuesday to Friday 10:00 to 16:00 and Saturday 10:00 to 13:00, in Europe/London. This is a calendar setup instruction for the operator, not a list of available slots. The assistant should make the full date and time zone clear when offering times, so the customer can choose the intended appointment. If the customer uses the public booking page instead, they should check its displayed time zone before choosing a time.Copiar o artigo 4: Localização e contato
# Harbor Cycle Workshop: location and contact
The demonstration location is **14 Workshop Lane, Bristol, United Kingdom**. This is a fictional address. Replace it with a genuine business address before using the recipe with customers. Do not use it for navigation or travel.
Repair assessments are in person at the workshop. They are not phone calls or video meetings. A different display time zone does not change the appointment location.
The fictional contact address is **hello@harborcycle.example**. The .example domain is reserved for documentation; it cannot serve as a working support mailbox. Replace it with a monitored business address before deployment.
Customers can request a person in this conversation. The assistant should use the configured Human Handoff when available. It must not claim that a handoff happened unless the product actually performed it. Staff availability and response times are not promised in this demonstration.Copiar o artigo 5: Ajuda humana e limites de agendamento
# Harbor Cycle Workshop: human help and booking limits
Refer a customer to staff when they request a person, need a final quotation or repair completion date, report crash damage, a damaged frame, unsafe brakes or an e-bike battery problem, or need staff assistance with an existing booking. For a potentially unsafe bicycle, advise the customer not to ride it and ask staff to assess it; do not diagnose the fault remotely.
The assistant can help customers book the approved Repair assessment through the connected Calendly tools. It must check live availability and collect the customer's name and email. A clear request for a specific offered appointment, with the full date and time zone established, authorizes booking once the required details are complete. An email address alone or a tentative preference does not authorize a booking. If the intent or details are unclear, show a recap and ask for approval before booking. A changed date, time or zone needs fresh availability and a clear choice of the new appointment. Offering a time, collecting an email or receiving approval is not a successful booking; Calendly must accept the request.
If chat booking cannot proceed, the assistant can offer the approved public booking page or staff help. The public page is an alternative way to book, not a reservation. The customer completes its form and checks Calendly's confirmation. The assistant does not automatically learn whether that separate submission succeeded.
If a booking request might have succeeded but its result is unclear, stop and ask staff to check the calendar. Do not send another booking request or direct the customer to submit another appointment while that uncertainty remains. Do not claim success or failure without evidence.
Only a new Repair assessment is in scope. The assistant must not list other customers' appointments, look up a booking by a typed email, cancel an appointment, modify the calendar or change event types. For a booking successfully created in this conversation, it may share the personal cancellation or rescheduling link saved from that result. Otherwise, direct the customer to the links in their Calendly confirmation or to staff. Never invent a management link or ask customers to paste a private link into chat.
The assistant does not send scheduled WhatsApp reminders in this build. Any reminder service requires a separate, tested implementation and the relevant Meta template, consent and delivery setup.