Carrossel Templates 6 de novembro de 2025 18:43 Atualizado Índice: Tipo de conteúdo: Carrossel Criação do Carrossel Template: Portal (Novo) Enviar Carrossel Template: Portal (Novo) Criação do Carrossel Template: API Enviar Carrossel Template: API Notificação Ativa Como conteúdo dinâmico Modelo de Mensagem Carrossel Por se tratar de um modelo de mensagem do WhatsApp, o envio do Carrossel é cobrado conforme a precificação de mensagem ativa de Marketing/Utilidade, mesmo se for enviado como conteúdo dinâmico no fluxo das mensagens. Esse template permite você enviar uma única mensagem de texto acompanhada por um conjunto de até 10 Carrossel Cards em uma visualização horizontal com scroll. Crie o Modelo Carrossel no Portal Blip (Novo) Acesse o portal do Blip, selecione um chatbot que tenha um número do WhatsApp ativado e acesse o módulo de Conteúdos. Selecione o item Modelo de Mensagens e clique no botão "Criar modelo". Uma caixa lateral aparecerá para preenchimento das informações necessárias para a submissão de um modelo de mensagem. O botão de Enviar para avaliação só será liberado após o preenchimento de todos os campos obrigatórios. Todo modelo de mensagem deve ter um corpo de texto obrigatório (Body) e pode incluir um Cabeçalho (Header) e Rodapé (Footer) para contexto adicional. Preencha: Nome do modelo: Use apenas letras minúsculas, números ou o caracter underline (_) para separar as palavras. Categoria: Selecione a categoria mais próxima do conteúdo. Lembre-se: A Meta classifica modelos que combinam utilidade e marketing como Marketing. Idioma do modelo: Selecione o idioma do template. Tipo de Conteúdo: Escolha o formato Carrossel (os tipos suportados são: Texto, Imagens, Documentos, Vídeos e Carrossel). Adicionar Tradução (Opcional): Você pode disponibilizar diferentes traduções para o mesmo modelo. Clique em "Adicionar tradução" para configurar outros idiomas. ’ O Carrossel inclui um corpo de mensagem principal (texto), seguido por uma coleção de Cartões interativos (com imagem ou vídeo). Cada Cartão é um mini-template e deve conter: Componente Boas práticas Limitações do canal Corpo do texto Mantenha o texto principal curto e atrativo, acima do carrossel. Use variáveis ({{1}}) aqui, se necessário, para personalizar o corpo da mensagem. Obrigatório. É estático e não rola com os cartões. Carrossel Pense em cada cartão como uma oportunidade única para o CTA (Call to Action). A imagem é o principal chamariz. Mínimo 2 e Máximo 10 cartões. Deve ser um único componente do tipo CAROUSEL. Cabeçalho Use imagens ou vídeos de alta qualidade que complementem o produto/serviço do cartão. O Header é a parte mais importante para gerar o clique. Obrigatório ser Mídia (Imagem ou Vídeo) em todos os cartões. Para hospedagem dos vídeos e imagens, utilize servidores válidos como: Google Drive, Amazon S3, Imgur, etc. Botões Mantenha a clareza. Não é permitido misturar tipos de botões entre os cartões (ex: se um tem Link, todos devem ter Link). 4. Clique em "Enviar para avaliação". Na tela seguinte (modal), forneça os Exemplos de Variáveis. Essa informação é essencial para a Meta compreender o caso de uso e aprovar o modelo. Com todos os campos devidamente preenchidos, clique em Enviar para avaliação. Ao submeter para avaliação, um modal abrirá para que você forneça os Exemplos de variáveis. Preencha com exemplos de valores para as variáveis do seu template, pois essa informação ajuda no entendimento do caso de uso do modelo de mensagem durante o processo de revisão pela Meta. Envio do Carrossel Template: Portal (Novo) Após a aprovação da Meta, você pode usar o modelo para disparos de mensagens ativas. 1. Selecione o canal Localize o seu roteador com o canal do WhatsApp no conectado no Portal e acesse a área Growth no menu principal. Escolha o canal do WhatsApp e siga o processo padrão para a ação de disparo ativo, considerando que: 2. Audiência Ao preparar sua audiência, mapeie as variáveis do corpo da mensagem (ex: {{1}}) para a coluna correspondente no seu arquivo (ex: {{1}} → coluna NOME). Este é o passo mais crítico para o disparo. Para as imagens dos Cartões: No disparo em massa, as variáveis do carrossel (que representam a URL da imagem de cada cartão) devem ser mapeadas para colunas que contenham o link de acesso público da mídia e demais variáveis. No disparo individual, insira o link e preencha as variáveis em cada campo e aba correspondente dos cards na etapa de Modelo. 3. Modelo Na etapa de seleção do modelo, encontre o Template Carrossel aprovado. Uma prévia estática será carregada à direita para você visualizar a mensagem final. 4. Redirecionamento Configure o direcionamento e revise antes de disparar as mensagens para sua audiência. Como enviar uma mensagem ativa em Growth Criação do Carrossel Template: API Para criar o Carrossel Template será necessário realizar os passos a seguir, através dos comandos listados abaixo e para executar esses comandos você precisará da URL de comando da sua organização e da API-Key. Clique aqui para saber como encontrar. 1. Adicionar mídias que serão utilizadas no template As mídias que serão usadas no header dos cards devem ser enviadas previamente para obter o valor do handler que será então adicionado na criação do template. A plataforma do Blip se encarregará de chamar a API da Meta e realizar o upload da mídia. Segue o detalhamento do comando: ORGANIZATION_ID: é o identificador da organização. YOUR_TOKEN: é a chave de autorização do seu bot. POST https://{ORGANIZATION_ID}.http.msging.net/commands HTTP/1.1 Content-Type: application/json Authorization: Key {YOUR_TOKEN} {"id": "{{$guid}}","method": "set", "to": "postmaster@wa.gw.msging.net","type": "application/vnd.lime.media-link+json","uri": "/message-templates-attachment","resource": { "uri": "https://www.blip.ai/wp-content/uploads/2023/06/Blip_General_Thumb.png"}} A resposta desta chamada conterá informações da mídia, a mais importante delas é o campo fileHandle, que será utilizado na criação do template. {"type": "application/json","resource": { "uploadSessionId": "upload:MTphdHR………………", "fileHandle": "4::aW1hZ2UvcG5n:ARb4uJ6m………………..", "fileSize": "43122", "fileSizeUploaded": "43122"},"method": “set”,"status": “success”,"id": “{{$guid}}”,"from": “postmaster@wa.gw.msging.net/#msging-gateway-whatsapp”,,"to": “botid@msging.net/#msging-server”,"metadata": { "traceparent": "00-111ss26458-4f584a16e5tr4dd5d55d5d", "#command.uri": "lime://botid@msging.net/message-templates-attachment"}} 2. Criar Carrossel Template Para criar o template do carrossel deve ser enviado o seguinte comando: ORGANIZATION_ID: é o identificador da organização. YOUR_TOKEN: é a chave de autorização do seu bot. POST https://{ORGANIZATION_ID}.http.msging.net/commands HTTP/1.1Content-Type: application/jsonAuthorization: Key {YOUR_TOKEN}{"id": "{{$guid}}","method": "set", "to": "postmaster@wa.gw.msging.net","type": "application/json","uri": "/message-templates","resource": { "name": "<TEMPLATE_NAME>", "language": "<TEMPLATE_LANGUAGE>", "category": "<TEMPLATE_CATEGORY>", "components": [/* Message bubble, required */ { "type": "BODY", "text": "<BUBBLE_TEXT>", "example": { "body_text": [ [ "<BUBBLE_TEXT_VAR_EXAMPLE_1>", "<BUBBLE_TEXT_VAR_EXAMPLE_2>" ] ] } },/* Carousel cards*/ { "type": "CAROUSEL", "cards": [/* Begin first carousel card */ { "components": [ { "type": "HEADER", "format": "<CARD_HEADER_FORMAT>", "example": { "header_handle": [ "<CARD_HEADER_HANDLE>" ] } }, { "type": "BODY", "text": "<CARD_BODY_TEXT>", "example": { "body_text": [ [ "<CARD_BODY_TEXT_VAR_EXAMPLE_1>", "<CARD_BODY_TEXT_VAR_EXAMPLE_2>" ] ] } }, /* At least one button required */ { "type": "BUTTONS", "buttons": [ { "type": "QUICK_REPLY", "text": "<QUICK_REPLY_BUTTON_TEXT>" }, { "type": "URL", "text": "<URL_BUTTON_TEXT>", "url": "<URL_BUTTON_URL>", "example": [ "<URL_BUTTON_VAR_EXAMPLE>" ] } ] } ] },/* End first carousel card */ ] } ]}} Template TEMPLATE_NAME: nome do carrossel template. TEMPLATE_LANGUAGE: Idioma do template. TEMPLATE_CATEGORY: Categoria do template. Message bubble BUBBLE_TEXT: Texto. Máximo 1024 caracteres. BUBBLE_TEXT_VAR_EXAMPLE: Valores em texto, referente às variáveis que são substituídas no BUBBLE_TEXT, caso tenha. O número de variáveis deve corresponder ao número incluídas em BUBBLE_TEXT. Exemplo: { "type": "BODY", "text": "Use the coupon {{1}} to get discount in {{2}}", "example": { "body_text": [ [ "NEWCLIENT", "SHOES" ] ] }} Carousel cards onde, cada cards é definido como será apresentado. CARD_HEADER_FORMAT: formato da mídia. Deve ser imagem ou vídeo. (image/video) CARD_HEADER_HANDLE: valor fileHandle, retornado pela Meta na requisição da etapa anterior. CARD_BODY_TEXT: Texto do card, máximo 160 caracteres. CARD_BODY_TEXT_VAR_EXAMPLE: Valores em texto, referente às variáveis que são substituídas no CARD_BODY_TEXT, caso tenha. O número de variáveis deve corresponder ao número incluídos em CARD_BODY_TEXT. Botões do card. Pelo menos um é obrigatório QUICK_REPLY_BUTTON_TEXT: texto do botão de quick reply. Máximo 25 caracteres. URL_BUTTON_TEXT: texto, label da url. Suporta apenas 1 variável. Máximo de 25 caracteres. URL_BUTTON_URL: url com parâmetros. Suporta apenas 1 variável. Máximo 2000 caracteres. URL_BUTTON_VAR_EXAMPLE: url com parâmetro preenchido de exemplo, referente às variáveis que são substituídas no URL_BUTTON_URL, caso tenha. A resposta desta chamada conterá informações como o ID do carrossel template criado e o status da requisição, se success, o template foi criado com sucesso. {"type": "application/json","resource": {"id": "1854……"},"method": "set","status": "success","id": "{{$guid}}","from": “postmaster@wa.gw.msging.net/#msging-gateway-whatsapp”,,"to": “botid@msging.net/#msging-server”,"metadata": {"traceparent": "00-9cee92d86c62fcc09189d6c61186d5b6-b0fcf66ee873c1b3-01","#command.uri": "lime://botid@msging.net/message-templates"}} Ainda não é possível visualizar o seu novo template no Blip, mas você poderá ver seu template criado no gerenciamento de Wabas Enviar Carrossel Template Após o template de carrossel ter sido criado é possível enviar o modelo de mensagem contendo o Carrossel. Há duas formas de enviá-lo: como uma mensagem ativa ou no fluxo do builder através de conteúdo dinâmico. Independente da forma que for enviado, por ser um template irá ser cobrado como mensagem ativa. Mensagem ativa Para envio de mensagens ativas, antes deve ser realizado o comando de verificação do número, conforme documentação. ORGANIZATION_ID: é o identificador da organização. YOUR_TOKEN: é a chave de autorização do seu bot. USER_PHONE_NUMBER: número de telefone do usuário que receberá a mensagem do carrossel template, conforme consultado na documentação. CAROUSEL_TEMPLATE_NAME: nome do carrossel template que foi criado POST https://{ORGANIZATION_ID}.http.msging.net/messages HTTP/1.1 Content-Type: application/json Authorization: Key {YOUR_TOKEN} {"id": "{{$guid}}","to": "{USER_PHONE_NUMBER}@wa.gw.msging.net","type": "application/json","content": { "type": "template", "template": { "name": "<TEMPLATE_NAME>", "language": { "code": "<TEMPLATE_LANGUAGE>" }, "components": [ /* Message bubble; can omit if template message bubble has no variables */ { "type": "BODY", "parameters": [ { "type": "TEXT", "text": "20OFF" }, { "type": "TEXT", "text": "20%" } ] },/* Carousel cards */ { "type": "CAROUSEL", "cards": [ { "card_index": 0, "components": [ { "type": "HEADER", "parameters": [ {/* Required if template uses image header, otherwise omit */ "type": "IMAGE", "image": { "link": "https://www.blip.ai/wp-content/uploads/2023/06/Blip_General_Thumb.png" }/* Required if template uses video header, otherwise omit */ "type": "VIDEO", "video": { "id": "12345678978569" } } ] },/* Can be omitted if card body text in template has no variables */ { "type": "BODY", "parameters": [ { "type": "TEXT", "text": "10OFF" }, { "type": "TEXT", "text": "10%" } ] }, { "type": "BUTTON", "sub_type": "QUICK_REPLY", "index": "0", "parameters": [ { "type": "PAYLOAD", "payload": "59NqSd" } ] }, { "type": "BUTTON", "sub_type": "URL", "index": "1", "parameters": [ { "type": "PAYLOAD", "payload": "last_chance_2023" } ] } ] }, { "card_index": 1, "components": [ { "type": "HEADER", "parameters": [ { "type": "IMAGE", "image": { "id": "24230790383178626" } } ] }, { "type": "BODY", "parameters": [ { "type": "TEXT", "text": "30OFF" }, { "type": "TEXT", "text": "30%" } ] }, { "type": "BUTTON", "sub_type": "QUICK_REPLY", "index": "0", "parameters": [ { "type": "PAYLOAD", "payload": "7C4xhY" } ] }, { "type": "BUTTON", "sub_type": "URL", "index": "1", "parameters": [ { "type": "PAYLOAD", "payload": "summer_blues_2023" } ] } ] } ] } ] }}} Como conteúdo dinâmico Para envio do carrossel como conteúdo dinâmico, deve ser adicionado no fluxo o componente do tipo conteúdo dinâmico, conforme a documentação, onde: Type: application/json Content: json, o mesmo valor que foi atribuído no campo “content” da requisição de envio de mensagem para notificação ativa. Exemplo: Observação: Mesmo estando como conteúdo dinâmico no fluxo de conversas, será cobrado como uma mensagem ativa, por se tratar de um template. Gerenciamento de modelos de mensagem da Meta Artigos relacionados Como usar Conteúdo Dinâmico Criando mensagens interativas no WhatsApp Configuração do arquivo de audiência - Envio de notificações em massa Envio de Mensagens Ativas do WhatsApp no Blip Desk Entenda a sua base que receberá a mensagem