Usando dados do pré-chat no prompt e nas ações
Nível: Intermediário Tempo de leitura: 6 min
O que são as variáveis de pré-chat
Quando um usuário preenche o formulário de entrada do seu agente, as informações são salvas no perfil do contato e ficam disponíveis em três lugares:
- No system prompt: o agente já sabe os dados do visitante antes da primeira mensagem
- Em campanhas de WhatsApp: os campos do contato são usados como variáveis nos templates
- No payload das ações (webhooks): quando o agente aciona uma ação, os dados do usuário são enviados junto ao sistema externo
Variáveis no system prompt
Use {{contact.chave}} no system prompt para inserir o valor de qualquer campo do contato, onde chave é o identificador interno do campo.
Campos personalizados
Para cada campo personalizado criado em Conta → Campos personalizados, a chave é definida na criação do campo:
| Campo criado | Chave | Variável no prompt |
|---|---|---|
| Plano contratado | plano |
{{contact.plano}} |
| Nome da empresa | empresa |
{{contact.empresa}} |
| Número do pedido | numero_pedido |
{{contact.numero_pedido}} |
Campos padrão
Os campos de identificação padrão também ficam disponíveis como variáveis:
| Campo padrão | Chave | Variável no prompt |
|---|---|---|
| Nome | nome |
{{contact.nome}} |
email |
{{contact.email}} |
|
telefone |
{{contact.telefone}} |
|
| CPF | cpf |
{{contact.cpf}} |
| CNPJ | cnpj |
{{contact.cnpj}} |
| Data de nascimento | data_nascimento |
{{contact.data_nascimento}} |
Para ver todas as variáveis disponíveis, clique no botão Variáveis (ícone
{}) na barra de ferramentas do prompt. A seção Campos do contato lista todas as variáveis com um clique para inserir.
Exemplos no system prompt
Saudação personalizada
Você é a assistente virtual da Empresa X.
O cliente que está conversando é {{contact.nome}} e seu email é {{contact.email}}.
Cumprimente-o pelo nome na primeira mensagem.
Contexto com campo personalizado
Você é o agente de suporte da Loja Y.
Dados do cliente:
- Nome: {{contact.nome}}
- Email: {{contact.email}}
- Número do pedido: {{contact.numero_pedido}}
Use o número do pedido para buscar informações quando o cliente precisar
de ajuda com rastreamento, trocas ou cancelamentos.
Personalização por plano
Você é o assistente da Acme.
O cliente {{contact.nome}} está no plano {{contact.plano}}.
Se o plano for "enterprise", ofereça suporte prioritário.
Se for "basic", encaminhe para a central de autoatendimento.
Prompt com campo ausente
Se o campo pode estar vazio, escreva o prompt de forma que funcione mesmo sem o valor:
Você é o assistente da Acme. O cliente está conversando com você.
{{contact.plano}}Se o plano estiver informado, adapte a resposta ao nível de suporte correspondente.
Usando nas ações (webhooks)
Quando o agente aciona uma ação, o payload enviado ao webhook inclui automaticamente os dados do pré-chat dentro do objeto _wevi.user:
{
"parametro_extraido_pelo_agente": "valor",
"_wevi": {
"action": "nome_da_acao",
"conversation_id": "uuid-da-conversa",
"user": {
"name": "João Silva",
"email": "joao@empresa.com",
"metadata": {
"empresa": "Acme",
"plano": "pro",
"numero_pedido": "12345"
}
}
}
}
Você não precisa configurar nada. Basta ler _wevi.user no seu sistema de destino (CRM, ERP, Zapier, Make etc.).
Quais dados são enviados
Apenas os dados que o usuário preencheu no formulário são incluídos. Se um campo opcional ficou em branco, ele não aparece em metadata. Nome e email sempre aparecem em _wevi.user.name e _wevi.user.email (como string vazia se não preenchidos).
Casos de uso
Clínica: coleta nome, email e tipo de consulta no pré-chat. O prompt usa {{contact.tipo_consulta}} para o agente já iniciar com contexto. A ação de agendamento recebe _wevi.user e preenche o CRM automaticamente sem pedir os dados de novo.
E-commerce: coleta número do pedido no pré-chat. O prompt usa {{contact.numero_pedido}} para o agente buscar o pedido desde a primeira mensagem. O webhook de suporte recebe o número junto ao contexto da ação.
B2B / SaaS: coleta empresa e cargo. O prompt adapta o tom e o nível técnico com base em {{contact.cargo}}. O CRM recebe o lead qualificado com todos os dados.