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.](https://app.digi2b.com/storage/file/rrs0885f5ogtzqtncypcsda6xxrz) ## **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](/hc/ajuda/articles/como-criar-uma-caixa-de-entrada-de-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](http://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.