Central de Ajuda Iara Conversas

Como usar templates de WhatsApp

Open in
View as Markdown Open in ChatGPT Open in Claude
Suporte

Suporte

Última atualização em Jun 2, 2026

Use este guia quando você precisar configurar, entender ou validar Como usar templates de WhatsApp na IAra.

Antes de começar na IAra

  • Confirme que seu usuário tem permissão para acessar a área citada no artigo.
  • Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais.
  • Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar.

Guia detalhado

Os modelos do WhatsApp são formatos de mensagens pré-aprovados que permitem iniciar conversas com seus clientes. Eles são essenciais para enviar mensagens promocionais, atualizações de pedidos e notificações de suporte através do WhatsApp Business Platform.

Na tela: A tela de Modelos Meta é onde você confere os templates disponíveis para envio.

modelos Meta.

O que são modelos do WhatsApp?

Os modelos do WhatsApp são mensagens estruturadas que devem ser aprovadas pelo WhatsApp antes de serem enviadas aos clientes. Eles ajudam a garantir a conformidade com as políticas de mensagens do WhatsApp, ao mesmo tempo que permitem enviar comunicações profissionais e consistentes.

Os modelos podem incluir:

  • Mensagens de texto com variáveis personalizadas

  • Imagens, vídeos ou documentos como cabeçalhos

  • Botões de ação para respostas rápidas dos clientes

  • Botões de call to action com links para sites ou números de telefone

Categorias de modelos

O WhatsApp organiza os modelos em diferentes categorias com base na sua finalidade:

  • Utilitário - Mensagens transacionais como confirmações de pedidos e recibos

  • Marketing – Conteúdo promocional e ofertas especiais

  • Atualização de envio - Atualizações de entrega e status do pacote

  • Atualização de tickets - Notificações de casos de suporte

  • Resolução de problemas - Acompanhamento de atendimento ao cliente

O que não é compatível

Modelos de autenticação

  • AUTENTICAÇÃO modelos com códigos OTP e mensagens de verificação

  • Preenchimento automático de parâmetros de botão com valores OTP

  • Validação OTP e tratamento do tempo de expiração

Componentes interativos

  • LISTA modelos com opções selecionáveis

  • PRODUCT modelos com integração de catálogo

  • CATALOG modelos para navegação de produtos

  • Componentes de seleção múltipla

Componentes de permissão de chamada

  • CALL_PERMISSION_REQUEST modelos que exigem API de chamada do WhatsApp ativada

  • Botões de permissão de chamada e componentes de chamada interativos

Componentes de localização

  • LOCATION cabeçalhos com coordenadas do mapa

  • Endereço parâmetros com latitude/longitude

  • Modelos baseados em localização

Recursos avançados

  • Formatação rich text na criação do modelo (preservada no envio)

  • Modelos de carrossel com vários cartões

  • Formulário componentes para coleta de dados

  • Pagamento modelos de integração

  • Modelos de fluxo com lógica condicional

Modelos legados versus modelos aprimorados

IAra oferece suporte a dois formatos de modelo para garantir compatibilidade com todos os seus modelos existentes:

Modelos legados

Estes são modelos tradicionais que usam variáveis de texto simples. Eles trabalham com:

  • Mensagens de texto básicas

  • Substituição simples de variáveis (como inserir o nome do cliente)

  • Interações diretas com botões

Exemplo de formato legado:

{
  "parâmetros": ["John Doe", "12345", "2025-01-15"]
}

⚠️ Importante: O suporte a modelos legados será descontinuado na versão 4.7. Recomendamos a migração para modelos aprimorados para garantir funcionalidade contínua.

Modelos aprimorados

O novo formato aprimorado oferece recursos mais sofisticados:

  • Suporte de mídia - Envie imagens, vídeos e documentos

  • Variáveis avançadas – Personalização de texto mais flexível

  • Botões interativos – botões de URL com links dinâmicos, códigos de cópia e respostas rápidas

  • Melhor validação - Verificação em tempo real dos parâmetros do seu modelo

Exemplo de formato aprimorado:

{
  "corpo": {
    "1": "John Doe",
    "2": "12345",
    "3": "15/01/2025"
  },
  "cabeçalho": {
    "media_url": "https://example.com/image.jpg",
    "media_type": "imagem"
  },
  "botões": [
    {
      "tipo": "url",
      "parâmetro": "track123"
    }
  ]
}

Observação: todos os seus modelos legados existentes continuam funcionando por enquanto, mas você deve planejar a transição para modelos aprimorados. Os recursos aprimorados ficam automaticamente disponíveis quando você usa tipos de modelos compatíveis.

Verifique esta API para saber mais sobre os formatos de solicitação.

Como criar modelos de WhatsApp

Atualmente, os modelos do WhatsApp devem ser criados através do WhatsApp Business Manager:

  1. Acesse o gerenciador de negócios do WhatsApp - Acesse business.facebook.com

  2. Navegue até os modelos - Encontre a seção "Ferramentas de conta" e selecione "Modelos de mensagem"

  3. Criar novo modelo - Clique em "Criar modelo" e escolha o tipo de modelo

  4. Crie seu modelo - Adicione cabeçalho, corpo, rodapé e botões conforme necessário

  5. Enviar para aprovação - O WhatsApp analisará seu modelo (isso pode levar até 24 horas)

  6. Sincronizar com IAra - Depois de aprovados, os modelos aparecerão automaticamente ou você pode sincronizar manualmente os modelos via caixa de entrada na IAra

🚀 Em breve: Estamos planejando adicionar a criação de modelos diretamente na interface da IAra em uma versão futura, facilitando o design e o gerenciamento de seus modelos sem sair da IAra.

Como enviar modelos do WhatsApp

Os modelos do WhatsApp podem ser enviados de duas maneiras:

  • Conversas individuais - Envie modelos para clientes específicos durante conversas

  • Campanhas - Envie modelos para vários clientes de uma só vez usando o recurso de campanha da IAra

Enviando modelos em conversas

Etapa 1: acessar opções de modelo

Abra qualquer conversa com um contato do WhatsApp, clique no ícone de modelo no compositor de mensagens, selecione "Modelos do WhatsApp" no menu suspenso

Etapa 2: Escolha seu modelo

Navegue pelos seus modelos aprovados, use a barra de pesquisa para encontrar modelos específicos rapidamente

Etapa 3: Personalize sua mensagem

Dependendo do tipo de modelo, pode ser necessário preencher:

Para modelos de texto:

  • Nome do cliente, número do pedido ou outras informações personalizadas

  • Quaisquer campos variáveis marcados com {{1}}, {{2}}, etc.

Para modelos de mídia:

  • URL de imagem/vídeo - Forneça um link direto para seu arquivo de mídia

  • URL do documento – Link para PDFs, documentos do Word ou outros arquivos

  • A mídia deve ser acessível publicamente (não é necessário fazer login)

Para modelos de botão:

  • Parâmetros de URL – Links dinâmicos para botões de call to action

  • Copiar códigos - Códigos de desconto ou códigos de referência

  • Números de telefone – Para botões clique para ligar

Etapa 4: visualizar e enviar

  1. Revise sua mensagem no painel de visualização

  2. Verifique se todas as variáveis estão preenchidas corretamente

  3. Verifique se os URLs de mídia estão funcionando (se aplicável)

  4. Clique em "Enviar modelo" para entregar sua mensagem

Envio de modelos por meio de campanhas

Para enviar modelos para vários clientes de uma só vez:

Vá para WhatsApp Campanhas no painel da IAra, crie uma nova campanha e selecione WhatsApp como canal

Escolha seu modelo de WhatsApp entre as opções disponíveis e configure seu público e parâmetros de modelo

Observação: A funcionalidade da campanha permite que você alcance vários clientes de forma eficiente com o mesmo modelo de mensagem.

Perguntas frequentes (FAQ)

Perguntas Gerais

Por que não consigo ver todos os meus modelos do WhatsApp na IAra?

Somente modelos aprovados pelo WhatsApp e suportados pela IAra aparecerão. Os tipos de modelos não suportados (como modelos de autenticação com códigos OTP) são automaticamente filtrados.

Quanto tempo leva para novos modelos aparecerem na IAra?

Os modelos normalmente são sincronizados automaticamente após algum tempo e você também pode atualizá-los manualmente nas configurações da caixa de entrada.

Posso editar modelos diretamente na IAra?

Não, os modelos devem ser criados e editados no WhatsApp Business Manager. IAra é usado apenas para envio de modelos aprovados.

Por que preciso fornecer URLs para imagens e vídeos?

O WhatsApp exige que os arquivos de mídia sejam hospedados online e acessíveis ao público. Você não pode fazer upload de arquivos diretamente – você deve fornecer URLs funcionais para seu conteúdo de mídia.

Posso usar o mesmo modelo para clientes diferentes?

Sim! Os modelos são projetados para serem reutilizados. Basta preencher diferentes informações do cliente cada vez que enviar o modelo.

Solução de problemas

Meu modelo não é enviado. O que devo verificar?

Problemas comuns incluem:

  • Variáveis ausentes - Certifique-se de que todos os campos obrigatórios sejam preenchidos

  • URLs de mídia quebrados - Verifique se os links de imagem/vídeo/documento funcionam

  • Tamanho do arquivo muito grande - Verifique se os arquivos de mídia atendem aos limites de tamanho do WhatsApp

  • Modelo não aprovado - Confirme o status do modelo no WhatsApp Business Manager

Por que os clientes não conseguem ver minhas imagens/vídeos?

Isso geralmente significa:

  • O URL não é acessível publicamente

  • O formato do arquivo não é suportado

  • O arquivo é muito grande

  • O servidor de hospedagem está inoperante ou requer autenticação

Meus botões de URL não funcionam corretamente. Como faço para corrigir isso?

Para modelos com botões de URL dinâmicos, existem problemas conhecidos com determinadas configurações de modelo. Tente usar URLs estáticos em vez de parâmetros dinâmicos para obter funcionalidades mais confiáveis.

Posso enviar modelos para clientes que não me enviaram mensagens primeiro?

Sim, mas apenas para determinadas categorias de modelos:

  • Modelos de utilitários podem ser enviados a qualquer momento para fins transacionais

  • Modelos de marketing exigem a aceitação do cliente e têm janelas de envio específicas

*Siga sempre as diretrizes de conformidade do WhatsApp para sua região

Mídia e arquivos

Que tipos de arquivo posso usar em modelos?

Os formatos suportados incluem:

  • Imagens: JPEG, PNG (menos de 5 MB)

  • Vídeos: MP4, 3GPP (menos de 16 MB)

  • Documentos: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT (menos de 100 MB)

Conformidade e limites

Quantos modelos posso enviar por dia?

Isso depende dos limites da sua conta do WhatsApp Business e das cotas de mensagens. Entre em contato com o suporte do WhatsApp para saber os limites específicos da sua conta.

Existem restrições sobre quando posso enviar modelos de marketing?

Sim, os modelos de marketing têm janelas de envio específicas e exigem a aceitação do cliente. Verifique as políticas atuais do WhatsApp para sua região e tipo de negócio.

O que acontece se eu enviar muitas mensagens?

O WhatsApp monitora a qualidade das mensagens e as taxas de entrega. O envio de muitas mensagens malsucedidas ou indesejadas pode afetar os limites de mensagens e as taxas de aprovação de modelos da sua conta.

Precisa de mais ajuda?

Se você estiver enfrentando problemas não abordados neste guia:

  1. Verifique o status do modelo no WhatsApp Business Manager

  2. Verifique se os URLs de mídia estão funcionando e acessíveis publicamente

  3. Teste com dados de amostra antes de enviar aos clientes

  4. Entre em contato com seu administrador da IAra para questões específicas da conta

  5. Revise os modelos de políticas do WhatsApp para questões de conformidade

Lembre-se de que os modelos do WhatsApp são uma ferramenta poderosa para comunicação com a pessoa atendida quando usados corretamente. Concentre-se em fornecer valor aos seus clientes com mensagens relevantes e oportunas que respeitem suas preferências.PI

Como validar na IAra

  1. Execute o fluxo em uma conta ou conversa de teste.
  2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado.
  3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe.

Problemas comuns

  • Usuário sem permissão para acessar a configuração.
  • Nome de tela diferente entre versões ou contas.
  • Recurso dependente de plano, provedor externo ou habilitação pela Digi2B.
  • Falta de teste em conversa realista antes de liberar para a equipe.

Checklist final

  • [ ] Configuração revisada por um administrador.
  • [ ] Teste realizado com dado ou conversa controlada.
  • [ ] Impacto para agentes e gestores entendido.
  • [ ] Artigos relacionados revisados para evitar links quebrados.