> ## Documentation Index
> Fetch the complete documentation index at: https://help.ciarem.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Formulários do WhatsApp nos seus agentes de IA

> Deixe um agente qualificador coletar as respostas com um formulário do WhatsApp, um agente de agendamento marcar reuniões com um, e dê a qualquer agente formulários que você criou, com uma linha sobre quando enviar cada um.

No WhatsApp, um agente de IA pode enviar um [formulário do WhatsApp](https://help.ciarem.ai/pt/channels/whatsapp-forms.md) em vez de fazer pergunta após pergunta no chat. Isso se configura no editor do agente (**Central de controle > Equipe de agentes**, abra o agente), na etapa **Escolha quais formulários do WhatsApp este agente pode enviar e quando.** Salve o agente para aplicar.

## Agentes qualificadores: um botão

Ative **Coletar respostas com um formulário do WhatsApp**. As [perguntas](https://help.ciarem.ai/pt/ai-agent/agent-team.md) do agente viram o formulário:

* Uma pergunta entra no formulário quando tem uma propriedade em **Salvar a resposta**. O cartão mostra quais perguntas entram e por que as outras ficam no chat: sem propriedade (perguntada no chat), uma propriedade arquivada, uma propriedade de arquivo, ou uma propriedade de opções sem opções ou com opções demais.
* O botão precisa de pelo menos uma pergunta com propriedade.
* Todas as perguntas do formulário são obrigatórias. As que o contato já respondeu vêm preenchidas, então ele confirma com um toque.
* O agente envia o formulário na primeira resposta, mesmo a um simples "oi", enquanto houver alguma pergunta com propriedade sem resposta. Se o cliente responder no chat, o agente salva essas respostas como sempre.

## Agentes de agendamento: agendar com um formulário

Ative **Agendar reuniões com um formulário do WhatsApp**. O formulário pede **nome** e **email (opcional)** e depois mostra um seletor de dia e horário com seus horários livres, ao vivo. A reunião é marcada no seu calendário quando o cliente envia o formulário. Se alguém pegou aquele horário nesse meio-tempo, o formulário pede para escolher outro.

* **Precisa de um calendário de agendamentos.** Conecte um calendário e marque-o com **Usar para agendamentos** em **Configurações > Calendários** ([como](https://help.ciarem.ai/pt/ai-agent/booking-and-calendars.md)). Até lá o botão fica desativado.
* **O que oferece:** os próximos 14 dias, dentro da agenda do calendário de agendamentos e fora dos horários ocupados, reuniões de 30 minutos com link de videochamada. Os horários aparecem no fuso horário do calendário.
* **O email é opcional.** Se o cliente deixar vazio, ou apagar o que veio preenchido, a reunião é marcada mesmo assim, mas ele não recebe convite.
* O agente envia quando o cliente quer uma reunião ou pergunta por horários. Não oferece de novo enquanto a conversa já tiver uma reunião futura.

## O que acontece ao salvar

Salvar o agente publica o formulário dele no WhatsApp. Uma mensagem confirma (**Formulário do WhatsApp atualizado: 3 perguntas**, com **Ver formulário**) e o cartão mostra **Publicado no WhatsApp**. Se não deu para publicar, o cartão diz por quê: por exemplo, nenhum número de WhatsApp conectado, nenhum calendário de agendamentos, ou o motivo pelo qual a Meta o rejeitou. Corrija e salve de novo.

Os botões e textos fixos do formulário (como "Continuar" ou "Enviar") ficam no **Idioma principal** da sua equipe, definido na [Configuração básica](https://help.ciarem.ai/pt/ai-agent/basic-configuration.md).

## Qualquer agente: adicione seus próprios formulários

Todos os tipos de agente podem enviar formulários que você criou em [Gerenciar formulários](https://help.ciarem.ai/pt/channels/whatsapp-forms-builder.md). Em **Seus formulários**, clique em **Adicionar formulário**, escolha um formulário publicado e preencha **Quando enviar**, por exemplo "Quando o cliente pede um orçamento". O agente envia quando esse momento chega. Se mais de um servir, a ordem da lista decide.

Um formulário que não está publicado mostra **Não é enviado até ser publicado.** com um link **Abrir para publicar**.

**Personalizar este formulário** transforma o formulário próprio de um agente qualificador ou de agendamento em uma cópia editável, adiciona-a a **Seus formulários** e desativa o botão. A cópia começa como rascunho: edite, publique, e o agente passa a enviar a sua cópia.

## Quando o agente envia um formulário, e quando não

* Só no **WhatsApp**, e só ao responder. Os acompanhamentos nunca levam formulário.
* Só o agente que **está atendendo a conversa** envia os formulários dele. Se o roteamento escolher outro agente, valem os formulários desse agente. Veja [como funciona o roteamento](https://help.ciarem.ai/pt/ai-agent/agent-team.md).
* Não enquanto uma **pessoa** tiver assumido a conversa.
* **Uma vez por conversa** cada formulário. Se o cliente ignorar ou disser que não quer, o agente segue no chat e não envia de novo.

Teste no [playground](https://help.ciarem.ai/pt/ai-agent/playground.md): o agente mostra ali o formulário com dados de exemplo e você pode preenchê-lo como se fosse o cliente.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.