Os Modelos de Conteúdo do Twilio permitem enviar modelos de mensagens do WhatsApp pré-aprovados através dos seus canais de negócios WhatsApp do Twilio no Chatwoot. Esses modelos permitem iniciar conversas e enviar mensagens estruturadas que cumprem as políticas de mensagens do WhatsApp.

## **Tipos de Modelos 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 5MB)

* **Modelos de Vídeo**: Texto com cabeçalhos de vídeo (MP4/3GPP, máximo 16MB)

* **Modelos de Documento**: Texto com anexos de documentos (PDF/formatos Office, máximo 100MB)

* Suporte para URLs de mídia dinâmicas com variáveis

**Modelos de Resposta Rápida**

* Respostas de botão interativas gerenciadas pelo WhatsApp

* Ações de botão simples para respostas comuns

* Suporte a múltiplas variantes de idioma

**Modelos de Chamada para 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 Twilio:

1. **Conta Twilio**: Conta Twilio ativa com acesso à API de Negócios WhatsApp

2. **Modelos Aprovados**: Modelos criados e aprovados no Twilio Console

3. **Integração Chatwoot**: Canal WhatsApp Twilio configurado no Chatwoot

4. **Conta WhatsApp Business**: Perfil de Negócios WhatsApp verificado

## **Configurando Modelos**

1. Faça login no seu [Twilio Console](https://console.twilio.com/)

2. Navegue até **Messaging** → **Content Template Builder**

3. Clique em **Create new template**

4. Escolha o tipo de modelo: **Text**: Para mensagens de texto simples, **Media**: Para imagens, vídeos ou documentos, **Quick Reply**: Para botões interativos

5. Configure o modelo conforme o objetivo.

6. Envie o modelo para aprovação do WhatsApp

7. Aguarde pela aprovação (5 minutos a 24 horas)

8. Modelos aprovados recebem um ContentSid

9. Os modelos agora estão prontos para uso no Chatwoot

## **Sincronizando Modelos com o Chatwoot**

**Sincronização Automática via API**

Os modelos são sincronizados automaticamente quando você:

1. Abre o modal de modelos de conteúdo em uma conversa

2. Cria uma nova conversa com um canal WhatsApp Twilio

**Sincronização Manual**

Para administradores das caixas de entrada:

1. Vá para **Settings** → **Inboxes**

2. Selecione sua caixa de entrada WhatsApp Twilio

3. Clique no botão **Sync Templates**

4. Aguarde a notificação de conclusão da sincronização

## **Usando 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 **"WhatsApp Templates"** no menu suspenso

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTnAxRXdJPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--859d1249d1c6a48c60b489dbcd8e64c9cb051213/CleanShot%202025-08-26%20at%2013.49.16@2x.png)

#### **Passo 2: Escolha seu modelo**

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

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTzExRXdJPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--c4a753fd824fadbe3a6f3bb225fbdd38c7452d56/CleanShot%202025-08-26%20at%2013.51.19@2x.png)

#### **Passo 3: Personalize sua mensagem**

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

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCUFIxRXdJPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--75e325a080c3749165473b87370618b8246c0a4e/CleanShot%202025-08-26%20at%2013.51.56@2x.png)

## **Boas Práticas**

**Design de Modelos**

* Mantenha as mensagens concisas e claras

* Use variáveis para personalização

* Garanta que os arquivos de mídia estejam otimizados e acessíveis

* Teste os modelos antes de enviá-los para aprovação

**Uso de Variáveis**

* Utilize nomes de variáveis descritivos no Twilio Console

* Forneça exemplos claros para aprovação

* Mantenha o número de variáveis razoável (menos de 10 para melhor experiência do usuário)

**Diretrizes de Mídia**

* Hospede arquivos de mídia em servidores confiáveis e rápidos

* Use URLs HTTPS para todas as mídias

* Otimize o tamanho dos arquivos para entregas mais rápidas

* Inclua texto alternativo para modelos de mídia

**Conformidade**

* Siga as diretrizes da Política de Negócios do WhatsApp

* Certifique-se de que os modelos tenham finalidade empresarial legítima

* Respeite a privacidade do usuário e o consentimento

* Monitore o desempenho dos modelos 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 Twilio Console

**Falha na Sincronização do Modelo**

* **Causa**: Problemas de conexão API ou credenciais inválidas

* **Solução**: Verifique as credenciais Twilio e tente sincronizar novamente

**Mídia Não Carregando**

* **Causa**: URL de mídia inacessível ou formato incorreto

* **Soluções**: Verifique se a URL é publicamente acessível, confira o formato e limite de tamanho do arquivo, garanta o protocolo HTTPS

**Variáveis Não Funcionando**

* **Causa**: Formato de variável incorreto ou valores ausentes

* **Soluções**: Use o formato correto `{{1}}`, `{{2}}` no Twilio, preencha todas as variáveis obrigatórias no Chatwoot, confira se o número de variáveis corresponde ao modelo

## **Mensagens de Erro**

**"Template not found"**

* Modelo não sincronizado com o Chatwoot

* Faça a sincronização manual ou verifique a aprovação do modelo

**"Media file too large"**

* O arquivo excede os limites do WhatsApp

* Comprimir o arquivo ou utilize outro formato

**"Invalid template parameters"**

* Valores de variáveis ausentes ou incorretos

* Revise e preencha todos os campos obrigatórios

## **Exemplos de Modelos**

**Modelo de Texto Básico**

```
Name: welcome_message

Content: "Bem-vindo à {{1}}! Estamos ansiosos para ajudá-lo com {{2}}."

Variables: Nome da empresa, Tipo de serviço
```

**Vitrine de Produto (Modelo de Mídia)**

```
Name: product_launch

Media: Imagem do produto

Content: "🎉 Lançamento! {{1}} agora disponível por {{2}}. Oferta por tempo limitado!"

Variables: Nome do produto, Preço
```

**Confirmação de Pedido (Modelo de Texto)**

```
Name: order_confirmed

Content: "Olá {{1}}! Seu pedido {{2}} foi confirmado. Previsão de entrega: {{3}}."

Variables: Nome do cliente, ID do pedido, Data de entrega
```

**Modelo de Resposta Rápida**

```
Name: support_options

Content: "Como podemos ajudar você hoje?"

Buttons: "Suporte Técnico", "Faturamento", "Informações Gerais"
```

## **Limitações**

**Limitações Atuais**

* Modelos não suportados em campanhas (em breve em atualizações futuras)

* Modelos de list picker

* Modelos de catálogo

* Modelos de carrossel

**Limites de Modelos**

* Máximo de 100 variáveis por modelo

* Arquivos de mídia devem ser publicamente acessíveis

* Os modelos requerem aprovação do WhatsApp

* Numeração sequencial de parâmetros obrigatória

## **Suporte**

Para ajuda adicional:

* Consulte a [Documentação WhatsApp Twilio](https://www.twilio.com/docs/whatsapp)

* Veja as [Diretrizes da Plataforma de Negócios WhatsApp](https://developers.facebook.com/docs/whatsapp/business-platform)

* Entre em contato com seu administrador do sistema para questões técnicas

* Consulte a documentação do Chatwoot para orientações gerais sobre a plataforma