Use este guia quando você precisar configurar, entender ou validar **Como usar templates de conteúdo da Twilio** 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 de conteúdo da Twilio permitem que você envie modelos de mensagens do WhatsApp pré-aprovados por meio dos canais do Twilio WhatsApp Business na IAra. Esses modelos permitem iniciar conversas e enviar mensagens estruturadas que atendem às políticas de mensagens do WhatsApp. ## **Tipos de modelo suportados** **Modelos de texto** * Mensagens de texto simples com variáveis opcionais * Suporte para até 100 variáveis por modelo usando o formato `{{1}}`, `{{2}}` * Suporte multilíngue **Modelos de mídia** * **Modelos de imagem**: texto com cabeçalhos de imagem (JPEG/PNG, máximo 5 MB) * **Modelos de vídeo**: texto com cabeçalhos de vídeo (MP4/3GPP, máximo de 16 MB) * **Modelos de documento**: texto com anexos de documentos (formatos PDF/Office, máximo de 100 MB) * Suporte para URLs de mídia dinâmica com variáveis **Modelos de resposta rápida** * Respostas de botões interativos gerenciadas pelo WhatsApp * Ações simples de botões para respostas comuns * Suporte para múltiplas variantes de idioma **Modelos de apelo à ação** * **Modelos de botão de URL**: envie mensagens com botões de ação clicáveis * **Suporte a variáveis**: tanto o texto da mensagem quanto os parâmetros do botão podem incluir variáveis * **Tipos de ação**: botões de URL para pagamentos, reservas, sites, etc. ## **Pré-requisitos** Antes de usar os modelos de conteúdo da Twilio: 1. **Conta Twilio**: conta Twilio ativa com acesso à API do WhatsApp Business 2. **Modelos aprovados**: modelos criados e aprovados no Console da Twilio 3. **Integraçãa IAra**: canal Twilio WhatsApp configurado na IAra 4. **Conta WhatsApp Business**: perfil verificado do WhatsApp Business ## **Configurando modelos** 1. Faça login em seu [Console Twilio](https://console.twilio.com/) 2. Navegue até **Mensagens** → **Content Template Builder** 3. Clique em **Criar novo modelo** 4. Escolha o tipo de modelo: **Texto**: para mensagens de texto simples, **Mídia**: para imagens, vídeos ou documentos, **Resposta rápida**: para botões interativos 5. Configure o modelo com base na finalidade. 6. Envie modelo para aprovação do WhatsApp 7. Aguarde aprovação (5 minutos a 24 horas) 8. Os modelos aprovados recebem um ContentSid 9. Os modelos agora estão prontos para uso na IAra ## **Sincronizando modelos com IAra** **Sincronização automática via API** Os modelos são sincronizados automaticamente quando você: 1. Abra o modal de modelos de conteúdo em uma conversa 2. Crie uma nova conversa com um canal Twilio WhatsApp **Sincronização manual** Para administradores de caixa de entrada: 1. Vá para **Configurações** → **Caixas de entrada** 2. Selecione sua caixa de entrada do Twilio WhatsApp 3. Clique no botão **Sincronizar modelos** 4. Aguarde a notificação de conclusão da sincronização ## **Usando 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: ## **Práticas recomendadas** **Design de modelo** * Mantenha as mensagens concisas e claras * Use variáveis para personalização * Garanta que os arquivos de mídia estejam otimizados e acessíveis * Modelos de teste antes do envio para aprovação **Uso variável** * Use nomes de variáveis descritivos no console da Twilio * Forneça exemplos claros para aprovação * Mantenha a contagem de variáveis razoável (menos de 10 para melhor UX) **Diretrizes para a mídia** * Hospede arquivos de mídia em servidores rápidos e confiáveis * Use URLs HTTPS para todas as mídias * Otimize tamanhos de arquivo para entrega mais rápida * Incluir texto alternativo para modelos de mídia **Conformidade** * Siga as diretrizes da Política Comercial do WhatsApp * Garanta que os modelos atendam a propósitos comerciais legítimos * Respeite a privacidade e o consentimento do usuário * Monitore o desempenho do modelo e o status de aprovação ## **Solução de problemas** **Problemas comuns** **Modelo não aparece** * **Causa**: Modelo não aprovado pelo WhatsApp * **Solução**: verifique o status de aprovação no console da Twilio **Falha na sincronização do modelo** * **Causa**: problemas de conexão da API ou credenciais inválidas * **Solução**: verifique as credenciais do Twilio e tente sincronizar novamente **A mídia não carrega** * **Causa**: URL da mídia não acessível ou formato incorreto * **Soluções**: verificar se o URL está acessível publicamente, verificar o formato do arquivo e os limites de tamanho, garantir o protocolo HTTPS **Variáveis não funcionam** * **Causa**: Formato de variável incorreto ou valores ausentes * **Soluções**: Use o formato `{{1}}`, `{{2}}` correto no Twilio, preencha todas as variáveis necessárias na IAra, verifique a contagem de variáveis corresponde ao modelo ## **Mensagens de erro** **"Modelo não encontrado"** * Modelo não sincronizado com IAra * Execute a sincronização manual ou verifique a aprovação do modelo **"Arquivo de mídia muito grande"** *Arquivo excede limites do WhatsApp * Compacte o arquivo ou use um formato diferente **"Parâmetros de modelo inválidos"** * Valores de variáveis ausentes ou incorretos * Revise e preencha todos os campos obrigatórios ## **Exemplos de modelos** **Modelo de texto básico** ``` Nome: mensagem_de_boas-vindas Conteúdo: "Bem-vindo a {{1}}! Estamos felizes em ajudá-lo com {{2}}." Variáveis: Nome da empresa, Tipo de serviço ``` **Mostra do produto (modelo de mídia)** ``` Nome: product_launch Mídia: imagem do produto Conteúdo: "🎉 Novidade! {{1}} já está disponível por {{2}}. Oferta por tempo limitado!" Variáveis: Nome do produto, Preço ``` **Confirmação do pedido (modelo de texto)** ``` Nome: pedido_confirmado Conteúdo: "Olá {{1}}! Seu pedido {{2}} foi confirmado. Entrega prevista: {{3}}." Variáveis: Nome do cliente, ID do pedido, Data de entrega ``` **Modelo de resposta rápida** ``` Nome: support_options Conteúdo: "Como podemos ajudá-lo hoje?" Botões: "Suporte Técnico", "Faturamento", "Informações Gerais" ``` ## **Limitações** **Limitações atuais** * Modelos não suportados em campanhas (em atualizações futuras) * Modelos de seletor de lista * Modelos de catálogo * Modelos de carrossel **Limites do modelo** * Máximo de 100 variáveis por modelo * Os arquivos de mídia devem ser acessíveis publicamente *Os modelos exigem aprovação do WhatsApp * Numeração sequencial de parâmetros necessária ## **Suporte** Para obter ajuda adicional: * Verifique a [documentação do Twilio WhatsApp](https://www.twilio.com/docs/whatsapp) * Revise as [Diretrizes da Plataforma WhatsApp Business](https://developers.facebook.com/docs/whatsapp/cloud-api/) * Entre em contato com o administrador do sistema para problemas técnicos * Consulte a documentação da IAra para orientação geral da plataforma --- ## 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.