--- title: "O bloco Enviar mensagem na API Oficial" url: https://ajuda.botconversa.com.br/aula/bloco-enviar-mensagem section: "Criando automações" date_modified: 2026-09-16T22:23:33.971317+00:00 language: pt-BR --- # O bloco Enviar mensagem na API Oficial [Vídeo da aula](https://www.youtube.com/watch?v=pkrRl5n92D8) ## Resposta rápida O bloco **Enviar mensagem** é a "fala" do robô: tudo que o cliente recebe no WhatsApp sai dele. Você escreve o texto (com variáveis do contato), anexa imagem, vídeo, áudio ou arquivo e escolhe **um tipo de botão**: até três **botões de resposta**, que criam uma saída cada; um **botão de URL**; uma **lista** para muitas opções; ou um **Fluxo completo** (formulário do WhatsApp). Na API Oficial, o topo do bloco define se a mensagem é para **Dentro** ou **Fora** da janela de 24 horas; fora dela, só um modelo aprovado é enviado. **Tempo de leitura:** ~9 min**Para quem é:** Quem monta fluxos na API Oficial Ao final desta aula você vai dominar o bloco que aparece em todo fluxo e vai saber por que uma mensagem "não saiu" ou um botão "não apareceu", que são as duas dúvidas mais comuns de quem começa. Na próxima aula você monta o primeiro fluxo inteiro com ele. ## Para que serve o bloco Enviar mensagem? Um fluxo é uma sequência de blocos. Alguns fazem coisas nos bastidores (Ação, Condição); o Enviar mensagem é o que o cliente vê. Cada bloco pode enviar um ou mais elementos, um atrás do outro: um texto, uma imagem com legenda, um áudio, e por último uma pergunta com botões. ![Bloco Enviar mensagem aberto no construtor, com o texto da mensagem e três botões de resposta](https://lfdfrrdzcfagillurinx.supabase.co/storage/v1/object/public/article-images/03-automacoes/bloco-enviar-mensagem/passo-1.png) Cada botão de resposta cria uma saída própria no bloco; o fluxo segue por um caminho diferente conforme o que o cliente escolhe. ## O que é a opção Dentro ou Fora da janela? Na API Oficial, o topo do bloco tem um seletor com duas opções. Ele existe porque o WhatsApp só aceita texto livre nas 24 horas seguintes à última mensagem do cliente. **Dentro** da janela **Fora** da janela **Quando usar** O cliente escreveu nas últimas 24 horas: atendimento, fluxo disparado por ele, assistente de IA O cliente está há mais de 24 horas sem escrever: lembretes, remarketing, confirmações, notificações **O que dá para enviar** Texto livre, mídia, botões, listas, Flow Só um **modelo de mensagem aprovado** pela Meta, escolhido em uma lista **Se errar** Uma mensagem "dentro" para quem está fora da janela **não é entregue** Um modelo para quem está dentro é entregue, mas custa como modelo Em fluxos disparados na hora pelo cliente (palavra-chave, boas-vindas, campanha), use **Dentro**. Em fluxos que rodam depois de um tempo (sequências, lembretes, follow-up de carrinho), use **Fora** com um modelo, porque não há como garantir que a janela ainda está aberta. A aula anterior explica a janela e como aprovar modelos. ## O que dá para escrever no texto? - Formatação com **negrito**, _itálico_ e tachado, e emojis. - **Variáveis** do contato, como o primeiro nome ou um campo personalizado, para personalizar a mensagem. - Até **1024 caracteres** por mensagem de texto. Quer guardar o que o cliente responder? A opção de **salvar a resposta** em um campo transforma a mensagem em pergunta. Veja [Capturando respostas do cliente](/aula/capturando-respostas-do-cliente). ## Que tipos de botão existem? A API Oficial permite **um tipo de botão por mensagem**. Misturar tipos é a causa número um de "o botão não apareceu". Tipo Limite O que faz Ideal para **Botão de resposta** Até 3 por mensagem O clique devolve uma resposta ao fluxo e cria uma **saída** para cada botão Menus curtos, qualificação, escolhas rápidas **Botão de URL** 1 por mensagem Abre um link externo; não devolve resposta ao fluxo Checkout, catálogo, página institucional **Lista** Até 10 itens, em seções Abre um menu em janela com várias opções; cada item é uma saída Cardápios, catálogos, seleção de serviço **Fluxo completo** 1 por mensagem Abre um formulário do WhatsApp em tela cheia; o bloco fica com uma saída única Agendamento, cadastro, pesquisa Os formulários exigem um Flow publicado; o passo a passo está em [Fluxos do WhatsApp (Flows)](/aula/fluxos-do-whatsapp-flows). Precisa de mais de três opções sem lista? Quebre em duas mensagens ou use um menu numérico, em que o cliente digita o número da opção. ## Que tipos de conteúdo dá para enviar? Conteúdo Detalhes Use para **Texto** Com ou sem botões Qualquer mensagem **Imagem** Pode ter legenda Promoções, cardápios, materiais visuais **Vídeo** Respeite o tamanho permitido pela Meta Demonstrações, boas-vindas em vídeo **Arquivo** PDF e outros documentos Contratos, propostas, catálogos **Áudio** Mensagem de voz Humanizar o atendimento, explicações rápidas **Contato** Envia um cartão de contato Passar o número do vendedor ou do suporte ## O que são Atraso e AutoOff? - **Atraso:** espera um tempo antes de enviar o elemento seguinte. Um atraso de dois ou três segundos entre mensagens deixa a conversa com ritmo humano; atrasos longos servem para follow-ups. Para esperas de horas ou dias, prefira o bloco [Atraso inteligente](/aula/bloco-atraso-inteligente). - **AutoOff:** desliga a resposta padrão automática para aquele contato depois do envio. Use quando a conversa vai passar para um humano e o robô não deve responder por cima. Terminou de configurar? Clique em **Salvar** e confira, antes de sair, se o seletor está em Dentro ou Fora. O erro clássico é montar a mensagem inteira e deixar o seletor errado. ## Por que a mensagem não saiu ou o botão não apareceu? Sintoma Causa Correção Mensagem não enviada Bloco em "Dentro" para um contato fora da janela Troque para "Fora" com um modelo aprovado, ou garanta que o fluxo dispare logo após a mensagem do cliente Botão não aparece Mistura de tipos de botão na mesma mensagem, ou mais de três botões de resposta Um tipo por mensagem; para mais opções, use lista Botão com borda vermelha Botão de Fluxo completo sem um Flow selecionado Abra o botão e escolha o Flow publicado Modelo não aparece na lista de "Fora" Modelo ainda em revisão ou recusado Aguarde a aprovação ou corrija o modelo Texto cortado Mais de 1024 caracteres Divida em duas mensagens **API não oficial:** o bloco equivalente não tem o seletor de janela, porque não existe janela de 24 horas nessa conexão, e os limites de botões e listas são diferentes. O restante (texto, mídia, atraso, salvar resposta) funciona igual. **Pizzaria:** boas-vindas com três botões de resposta ("Fazer pedido", "Ver cardápio", "Falar com atendente"), cada um levando a um caminho. **Imobiliária:** uma lista com os bairros atendidos, agrupados por região, para o cliente escolher onde procurar. **Curso online:** o catálogo em PDF seguido de um botão de URL para a página de matrícula, e um lembrete "Fora" da janela dois dias depois, com modelo de utilidade. ## Dicas - **Confira o seletor Dentro/Fora antes de salvar.** Todo bloco, toda vez. - **Uma ideia por mensagem.** Três mensagens curtas convertem mais que um bloco de texto. - **Listas para muitas opções, botões para poucas.** Três botões cabem na tela; dez opções pedem lista. - **Teste com contato de teste** depois de qualquer mudança em botões. A visualização do construtor não substitui o WhatsApp real. - **Desde outubro de 2026 cada mensagem tem custo** na API Oficial, inclusive dentro da janela. Mensagens a menos são dinheiro a mais; veja [Cobrança dentro da janela de 24h](/aula/cobranca-dentro-da-janela-de-24h). **🎯 Missão desta aula:** em um fluxo de teste, crie uma mensagem "Dentro" com três botões de resposta e uma segunda mensagem "Fora" usando o modelo de utilidade que você criou na aula anterior. **Checkpoint:** o bloco de botões mostra três saídas e o bloco "Fora" mostra o nome do modelo. ## Perguntas frequentes Posso colocar o nome do cliente na mensagem? Sim. Ao escrever o texto, use o seletor de variáveis para inserir o primeiro nome ou qualquer campo do contato. Quantos botões posso usar? Até três botões de resposta por mensagem na API Oficial. Para mais opções, use uma lista de até dez itens. Posso ter um botão de resposta e um de URL na mesma mensagem? Não. É um tipo de botão por mensagem. Mande o URL em uma segunda mensagem. Por que a mensagem não sai depois de horas? A conversa saiu da janela de 24 horas e o bloco está em "Dentro". Só um modelo aprovado, no modo "Fora", reabre o contato. O bloco de conteúdo e o Enviar mensagem são a mesma coisa? Sim. Bloco de conteúdo é o nome antigo, ainda usado em vídeos mais antigos.