Os modelos do WhatsApp são formatos de mensagens pré-aprovados que permitem iniciar conversas com seus clientes. Eles são essenciais para o envio de mensagens promocionais, atualizações de pedidos e notificações de suporte através da Plataforma WhatsApp Business. **Nota:** Atualmente, os modelos do WhatsApp são compatíveis apenas com as caixas de entrada do WhatsApp Cloud. ## **O que são modelos do WhatsApp?** Os modelos do WhatsApp são mensagens estruturadas que precisam ser aprovadas pelo WhatsApp antes de serem enviadas aos clientes. Eles ajudam a garantir a conformidade com as políticas de mensagens do WhatsApp e permitem o envio de 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** que redirecionam para sites ou números de telefone ## **Categorias de Modelos** O WhatsApp organiza os modelos em diferentes categorias de acordo com seu propósito: * **Utilidade** - 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 de pacotes * **Atualização de ticket** - Notificações de casos de suporte * **Resolução de problemas** - Acompanhamentos de atendimento ao cliente ## **O que não é suportado** ### **Modelos de autenticação** * Modelos de **AUTENTICAÇÃO** com códigos OTP e mensagens de verificação * **Auto-preenchimento** de parâmetros de botão com valores OTP * **Validação de OTP** e controle de tempo de expiração ### **Componentes interativos** * Modelos de **LISTA** com opções selecionáveis * Modelos de **PRODUTO** com integração ao catálogo * Modelos de **CATÁLOGO** para navegação de produtos * Componentes de **multi-seleção** ### **Componentes de permissão de chamada** * Modelos de **SOLICITAÇÃO_DE_PERMISSÃO_DE_CHAMADA** que exigem API de chamada do WhatsApp habilitada * Botões de permissão de chamada e componentes interativos de chamada ### **Componentes de localização** * Cabeçalhos de **LOCALIZAÇÃO** com coordenadas de mapa * Parâmetros de **endereço** com latitude/longitude * Modelos baseados em **localização** ### **Recursos avançados** * **Formatação de texto rica** na criação de modelos (preservada no envio) * Modelos de **carrossel** com vários cartões * Componentes de **formulário** para coleta de dados * Modelos com integração de **pagamento** * Modelos de **fluxo** com lógica condicional ## **Modelos legados vs avançados** O Chatwoot suporta dois formatos de modelo para garantir compatibilidade com todos os seus modelos existentes: ### **Modelos legados** São modelos tradicionais que utilizam variáveis simples de texto. Eles funcionam com: * Mensagens de texto básicas * Substituição simples de variáveis (como inserir o nome do cliente) * Interações de botões simples **Exemplo de formato legado:** ``` { "parameters": ["John Doe", "12345", "2025-01-15"] } ``` **⚠️ Importante:** O suporte a modelos legados será descontinuado na versão v4.7. Recomendamos migrar para os modelos avançados para garantir a continuidade do funcionamento. ### **Modelos avançados** O novo formato avançado oferece recursos mais sofisticados: * **Suporte a 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 para copiar e respostas rápidas * **Melhor validação** - Verificação em tempo real dos parâmetros do seu modelo **Exemplo de formato avançado:** ``` { "body": { "1": "John Doe", "2": "12345", "3": "2025-01-15" }, "header": { "media_url": "https://example.com/image.jpg", "media_type": "image" }, "buttons": [ { "type": "url", "parameter": "track123" } ] } ``` **Nota:** Todos os seus modelos legados existentes continuam funcionando por enquanto, mas você deve planejar a transição para modelos avançados. Os recursos avançados ficam disponíveis automaticamente ao utilizar os tipos de modelo suportados. Verifique esta [API](https://developers.chatwoot.com/api-reference/messages/create-new-message) para saber sobre os formatos de requisição. ## **Como criar modelos do WhatsApp** Atualmente, os modelos precisam ser criados através do **Gerenciador de Negócios do WhatsApp**: 1. **Acesse o Gerenciador de Negócios do WhatsApp** - Vá para [business.facebook.com](http://business.facebook.com) 2. **Navegue até os modelos** - Encontre a seção "Ferramentas da Conta" e selecione "Modelos de mensagens" 3. **Crie um novo modelo** - Clique em "Criar modelo" e escolha o tipo do seu modelo 4. **Desenhe seu modelo** - Adicione cabeçalho, corpo, rodapé e botões conforme necessário 5. **Envie para aprovação** - O WhatsApp revisará seu modelo (isso pode levar até 24 horas) 6. **Sincronize com o Chatwoot** - Após a aprovação, os modelos aparecerão automaticamente ou você pode sincronizar manualmente os modelos via caixa de entrada no Chatwoot **🚀 Em breve:** Estamos planejando adicionar a criação de modelos diretamente pela interface do Chatwoot em uma futura atualização, facilitando o design e gerenciamento dos modelos sem sair do Chatwoot. ## **Como enviar modelos do WhatsApp** Os modelos do WhatsApp podem ser enviados de duas maneiras: * **Conversas individuais** - Envie modelos para clientes específicos durante as conversas * **Campanhas** - Envie modelos para vários clientes ao mesmo tempo utilizando o recurso de campanhas do Chatwoot ### **Enviando modelos em conversas** #### **Passo 1: Acesse as opções de modelo** Abra qualquer conversa com um contato do WhatsApp, clique no **ícone de modelo** no editor de mensagens, selecione **"Modelos do WhatsApp"** no menu suspenso ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRHdUOUFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--257425a35b90c4a3b936f58c29eee946763157ef/CleanShot%202025-08-12%20at%2001.12.20@2x%201.png) #### **Passo 2: Escolha seu modelo** Percorra seus modelos aprovados, utilize a barra de busca para encontrar rapidamente modelos específicos ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQVVVOUFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--4da9876c768ccdb2ef56825c4634e68e7c62542e/CleanShot%202025-08-12%20at%2001.17.34@2x%201.png) #### **Passo 3: Personalize sua mensagem** Dependendo do tipo de modelo, pode ser necessário preencher: ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTTRUOUFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--0c7ab1c26180341571b6a4bcdfc63078ee41c710/CleanShot%202025-08-12%20at%2001.16.32@2x%201.png) **Para modelos de texto:** * Nome do cliente, número do pedido ou outras informações personalizadas * Quaisquer campos de variável marcados como {{1}}, {{2}}, etc. **Para modelos de mídia:** * **URL da Imagem/Vídeo** - Forneça um link direto para seu arquivo de mídia * **URL do Documento** - Link para PDFs, arquivos Word ou outros * **A mídia deve ser publicamente acessível** (sem necessidade de login) **Para modelos de Botão:** * **Parâmetros de URL** - Links dinâmicos para botões de call-to-action * **Códigos de cópia** - Códigos de desconto ou indicação * **Números de telefone** - Para botões de clique para ligar #### **Passo 4: Visualize e envie** 1. Revise sua mensagem no painel de visualização 2. Confira 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 ### **Enviando modelos por Campanhas** Para enviar modelos simultaneamente para vários clientes: Acesse **Campanhas Whatsapp** em seu painel do Chatwoot, crie uma nova campanha e selecione **WhatsApp** como canal ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRTRVOUFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--dcaa88c461718dae1746763a0d25b3538c8f16c5/CleanShot%202025-08-12%20at%2001.19.07@2x%201.png) Escolha seu modelo do WhatsApp entre as opções disponíveis e configure seu público e parâmetros do modelo ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRlRoOUFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--d702cb8e1080e0e96d647876eeaf048f7990c1bd/og-help-center%20(1).png) **Nota:** O recurso de campanhas permite alcançar vários clientes de forma eficiente usando a mesma mensagem de modelo. ## **Perguntas Frequentes (FAQ)** ### **Dúvidas Gerais** **Por que não vejo todos os meus modelos do WhatsApp no Chatwoot?** Apenas modelos aprovados pelo WhatsApp e suportados pelo Chatwoot serão exibidos. Tipos de modelo não suportados (como autenticação com códigos OTP) são automaticamente filtrados. **Quanto tempo leva para novos modelos aparecerem no Chatwoot?** Os modelos geralmente sincronizam automaticamente após algum tempo, e você também pode atualizá-los manualmente nas configurações da caixa de entrada. **Posso editar modelos diretamente no Chatwoot?** Não, os modelos devem ser criados e editados no Gerenciador de Negócios do WhatsApp. O Chatwoot é usado apenas para enviar modelos aprovados. **Por que preciso fornecer URLs para imagens e vídeos?** O WhatsApp exige que os arquivos de mídia estejam hospedados online e sejam publicamente acessíveis. Não é possível fazer upload direto de arquivos - é preciso fornecer URLs funcionais para o conteúdo da mídia. **Posso usar o mesmo modelo para clientes diferentes?** Sim! Os modelos são feitos para serem reutilizados. Basta preencher informações diferentes do cliente a cada novo envio. ### **Solução de Problemas** **Meu modelo não é enviado. O que devo verificar?** Problemas comuns incluem: * **Variáveis ausentes** - Certifique-se de preencher todos os campos obrigatórios * **URLs de mídia quebrados** - Verifique se seus links de imagem/vídeo/documento funcionam * **Arquivo muito grande** - Confirme se os arquivos de mídia atendem aos limites de tamanho do WhatsApp * **Modelo não aprovado** - Confira o status do modelo no Gerenciador de Negócios do WhatsApp **Por que os clientes não conseguem ver minhas imagens/vídeos?** Normalmente isso significa que: * O URL não é publicamente acessível * O formato do arquivo não é suportado * O arquivo é muito grande * O servidor de hospedagem está fora do ar ou exige autenticação **Meus botões de URL não funcionam corretamente. Como consertar?** Para modelos com botões de URL dinâmicos, existem problemas conhecidos com certas configurações de modelo. Tente usar URLs estáticas em vez de parâmetros dinâmicos para obter maior confiabilidade. **Posso enviar modelos para clientes que ainda não me enviaram mensagem?** Sim, mas apenas para certas categorias de modelo: * **Modelos de utilidade** podem ser enviados a qualquer momento para fins transacionais * **Modelos de marketing** exigem opt-in do cliente e têm janelas de envio específicas * Sempre siga as diretrizes de conformidade do WhatsApp para sua região ### **Mídia e Arquivos** **Quais tipos de arquivo posso usar em modelos?** Os formatos suportados incluem: * **Imagens:** JPEG, PNG (até 5MB) * **Vídeos:** MP4, 3GPP (até 16MB) * **Documentos:** PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT (até 100MB) ### **Conformidade e Limites** **Quantos modelos posso enviar por dia?** Depende dos limites e cotas de mensagens da sua conta WhatsApp Business. Contate o suporte do WhatsApp para limites específicos da sua conta. **Há restrições sobre quando posso enviar modelos de marketing?** Sim, modelos de marketing possuem janelas de envio específicas e exigem opt-in do cliente. Consulte 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 qualidade e taxas de entrega das mensagens. O envio de muitas mensagens malsucedidas ou indesejadas pode impactar os limites e taxas de aprovação dos seus modelos. ## **Precisa de mais ajuda?** Se estiver enfrentando problemas não abordados neste guia: 1. **Verifique o status do modelo** no Gerenciador de Negócios do WhatsApp 2. **Confirme que os URLs de mídia** funcionam e são publicamente acessíveis 3. **Faça testes com dados de exemplo** antes de enviar aos clientes 4. **Entre em contato com o administrador do Chatwoot** para questões específicas da sua conta 5. **Revise as políticas de modelos do WhatsApp** para dúvidas de conformidade Lembre-se: os modelos do WhatsApp são uma ferramenta poderosa de comunicação com o cliente quando usados corretamente. Foque em entregar valor aos seus clientes com mensagens relevantes e oportunas que respeitem suas preferências.