Central de Ajuda Iara Conversas

Como usar templates de conteúdo da Twilio

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

Suporte

Última atualização em Jun 1, 2026

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

  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:

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.