O Agente de IA da FiqOn traz uma maneira prática e escalável de transformar mensagens do WhatsApp em eventos no Google Calendar. Ideal para salões, clínicas, pet shops e qualquer negócio que precise agendar clientes sem depender de atendente humano.
Por que usar o Agente de IA da FiqOn?
O Agente de IA da FiqOn funciona como uma mente autônoma: recebe uma instrução, compreende o contexto, decide a melhor ação e executa usando ferramentas conectadas. Isso reduz custos, aumenta a confiabilidade do atendimento e entrega agendamentos confirmados diretamente no Google Calendar.
Visão geral do fluxo
- Receber mensagem no WhatsApp Business (via webhook/ZAPI).
- Filtrar mensagens irrelevantes (grupos, spam).
- Enviar o texto para o Agente de IA da FiqOn.
- Agente consulta memória do usuário (session ID).
- Agente checa disponibilidade no Google Calendar (tool).
- Se disponível, cria o evento no Google Calendar.
- Envia confirmação ao cliente via WhatsApp.
Passo a passo prático
1. Gatilho: webhook do WhatsApp (ZAPI)
Configure um webhook que receba mensagens do número comercial. O webhook será o ponto inicial do fluxo: sempre que chegar uma mensagem, a automação dispara.
Durante testes, use um filtro que restrinja a origem para seu número pessoal (assim você não responde a grupos acidentalmente). Em produção esse filtro pode ser removido.
2. Conectar o provedor de IA
No Agente de IA da FiqOn escolha o provedor (ex.: OpenAI) e cole sua chave API. Esse modelo será o “motor” que interpreta pedidos e decide quando chamar ferramentas.
3. Memória e session ID
Configure onde o agente vai buscar o histórico de conversas. Use o número do WhatsApp como session ID para que cada usuário tenha contexto próprio. Isso evita respostas genéricas e possíveis conflitos de agendamento.
4. Janela de contexto (context window)
Ajuste o tamanho do contexto conforme necessidade. Uma janela maior fornece mais histórico, mas pode causar respostas menos precisas se houver muito ruído. Teste e encontre o equilíbrio certo para sua operação.
5. Ferramentas (components): Google Calendar
No FiqOn, adicione as ferramentas que o agente pode usar. Para agendamento serão necessárias ao menos duas: checar disponibilidade e criar evento. Sempre comunique ao agente as condições (formato ISO 8601, horário de atendimento, duração padrão).
6. Prompt: defina regras claras
O prompt é o conjunto de regras que orienta o Agente de IA da FiqOn. Informe:
- Horário de funcionamento (ex.: 09:00–18:00).
- Duração padrão da consulta (ex.: 60 minutos).
- Formato de data/hora (ISO 8601 para Google Calendar).
- Fuso horário fixo (ex.: Brasília).
O agente não adivinha parâmetros que você não fornecer. Quanto mais claro e completo o prompt, mais previsíveis serão os resultados.
7. Envio de resposta ao cliente (ZAPI)
Configure o envio da mensagem de retorno usando o mesmo canal (ZAPI). A mensagem pode incluir hora confirmada e link do evento no Google Calendar.
Testes e validação
Teste o fluxo repetidamente. Idealmente, faça pelo menos 10 testes consecutivos cobrindo variações:
- Solicitação direta: “Quero agendar amanhã 10:00”.
- Solicitação vaga: “Tem horário de manhã?”
- Conflito: marcar horário já ocupado.
- Fuso e formatos diversos.
Troubleshooting: ordem de checagem
Quando algo falhar, siga esta ordem de verificação:
- Prompt: É o motivo mais comum de erro. Ajuste instruções, exemplos e parâmetros.
- Modelo de IA: Um modelo pequeno pode poupar custo, mas comprometer precisão. Tente um modelo com janela de contexto maior se necessário.
- Janela de contexto: Teste reduzir ou aumentar o contexto para ver o impacto.
- Ferramentas e permissões: Verifique conexões com Google Calendar e ZAPI.
- Filtros: Confirme que mensagens de teste não estão sendo bloqueadas por filtros (grupo, número).
Dicas práticas
- Automatize só o que for claro: comece com regras simples e vá ampliando.
- Padronize a duração: evita conflitos e simplifica checagens de disponibilidade.
- Logs e testes: mantenha histórico de logs para entender falhas.
- Mensagens amigáveis: confirme horário, duração e política de cancelamento na resposta ao cliente.
Exemplo rápido de prompt (modelo)
Você é o assistente virtual da empresa. Horário de atendimento: 09:00–18:00 (Brasília). Duração padrão: 60 minutos. Use ISO 8601. Ao receber pedido de agendamento:
1) Verifique disponibilidade no calendário.
2) Se disponível, crie evento com título, descrição e período (início e fim).
3) Responda ao cliente confirmando horário e link do evento.Conclusão
O Agente de IA da FiqOn permite transformar mensagens em agendamentos reais, reduzindo atrito e custos operacionais. Com webhook, filtro, memória por session ID, ferramentas bem configuradas e um prompt claro, é possível entregar agendamentos confiáveis diretamente pelo WhatsApp.
Teste, ajuste e priorize o prompt: essa é quase sempre a chave para o sucesso. Quando tudo estiver funcionando com consistência, esse serviço se paga rapidamente e abre portas para vender automações para outros negócios.
Boa sorte na implantação do seu Agente de IA da FiqOn.
