Conecta-seEntrar na plataforma

WhatsApp

Enviar mensagens, modelos, mídias, interações e reações pelo WhatsApp.

Integrações e ferramentasComunicaçãoConexão: Credencial protegida

O que faz

Integre o WhatsApp ao fluxo. Envie mensagens de texto, de modelo, de mídia e interativas, reaja a mensagens e marque mensagens como lidas pela WhatsApp Cloud API. Mensagens livres só chegam ao destinatário até 24 horas depois da última mensagem que ele enviou a você — fora dessa janela, o WhatsApp exige um modelo pré-aprovado.

Quando usar: Use quando o seu fluxo precisar enviar mensagens, modelos, mídias, interações e reações pelo WhatsApp.

Exemplo de situação: Enviar uma confirmação ao cliente ou à equipe no canal correto.

Antes de começar

Conexão necessária: Credencial protegida.

Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.

Passo a passo

  1. Adicione WhatsApp ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Para configurar o gatilho

  1. Acesse o Meta App Dashboard e abra o app conectado à sua configuração da WhatsApp Business Platform. Se você criou o app pelo caso de uso do WhatsApp, a página de configuração pode estar em Use cases &gt; Customize &gt; Configuration em vez de WhatsApp &gt; Configuration.
  2. Se você ainda não tem um app, crie um primeiro e adicione o produto WhatsApp antes de configurar os webhooks.
  3. Clique em "Salvar configuração" acima antes de verificar a URL de callback, para que a plataforma tenha uma configuração ativa de webhook do WhatsApp neste endereço. Se este fluxo já estiver publicado e você alterar o token de verificação ou o segredo do app, publique o fluxo de novo antes de verificar outra vez na Meta.
  4. Em WhatsApp &gt; Configuration, encontre a seção Webhooks e clique em Edit.
  5. Cole a URL do webhook acima no campo "Callback URL".
  6. Cole o Token de verificação no campo "Verify token".
  7. Copie o App Secret do seu app em App Settings &gt; Basic e cole no campo Segredo do app (App Secret) acima, para que a plataforma possa validar as assinaturas das requisições POST.
  8. Clique em "Verify and save".
  9. Clique em Manage ao lado dos campos do webhook e assine o campo messages. Esse campo cobre as mensagens recebidas e as atualizações de status das mensagens enviadas.

Operações

OperaçãoO que faz
Enviar mensagemEnvia mensagem com o bloco WhatsApp.
Enviar modeloEnvia modelo com o bloco WhatsApp.
Enviar mídiaEnvia mídia com o bloco WhatsApp.
Enviar mensagem interativaEnvia mensagem interativa com o bloco WhatsApp.
Enviar reaçãoEnvia reação com o bloco WhatsApp.
Marcar como lidaMarca como lida com o bloco WhatsApp.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Enviar mensagem · Enviar modelo · Enviar mídia · Enviar mensagem interativa · Enviar reação · Marcar como lida
    Padrão:
    Enviar mensagem

  • Telefone do destinatário

    Obrigatório conforme a operação

    Inclua o sinal de mais (+) e o código do país.

    Quando aparece:
    Quando o campo “Operação” for diferente de “Marcar como lida”
    Exemplo:
    +5511999999999

  • Mensagem

    Obrigatório conforme a operação

    Texto livre (máximo de 4096 caracteres). O WhatsApp só entrega esta mensagem até 24 horas depois da última mensagem do destinatário para você — fora dessa janela, use Enviar modelo.

    Aparece em:
    Enviar mensagem
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Pré-visualizar o primeiro link

    Em campos adicionais

    Faz o WhatsApp tentar exibir uma prévia do primeiro link da mensagem.

    Aparece em:
    Enviar mensagem
    Opções:
    Não · Sim
    Padrão:
    Não

  • Nome do modelo

    Obrigatório conforme a operação

    Informe o nome do modelo aprovado.

    Aparece em:
    Enviar modelo
    Exemplo:
    Exemplo de atendimento

  • Idioma do modelo

    Obrigatório conforme a operação

    Define o idioma do modelo ou conteúdo, como pt_BR ou en_US, no formato aceito pelo serviço.

    Aparece em:
    Enviar modelo
    Padrão:
    en_US
    Exemplo:
    pt-BR

  • Componentes do modelo

    Em campos adicionais

    Lista JSON de componentes do modelo com os parâmetros das variáveis.

    Aparece em:
    Enviar modelo
    Exemplo:
    [{"type":"body","parameters":[{"type":"text","text":"valor"}]}]

  • Tipo de mídia

    Obrigatório conforme a operação

    Informa ou seleciona o arquivo usado nesta operação.

    Aparece em:
    Enviar mídia
    Opções:
    Imagem · Documento · Vídeo · Áudio · Figurinha
    Padrão:
    Imagem

  • Mídia

    O arquivo é carregado no WhatsApp e depois enviado. Se for enviar o mesmo arquivo várias vezes, carregue a mídia uma vez e use o ID dela.

    Aparece em:
    Enviar mídia
    Exemplo:
    (selecione um arquivo de teste)

  • Mídia

    Em campos adicionais

    Referencie um arquivo de um bloco anterior.

    Aparece em:
    Enviar mídia

  • ID da mídia

    Em campos adicionais

    Alternativa ao campo Mídia. Reaproveita uma mídia já carregada por até 30 dias.

    Aparece em:
    Enviar mídia
    Exemplo:
    id-do-recurso

  • Link da mídia

    Em campos adicionais

    Alternativa ao campo Mídia. O WhatsApp baixa esta URL e a mantém em cache por 10 minutos.

    Aparece em:
    Enviar mídia
    Exemplo:
    https://api.exemplo.com/v1/recurso

  • Legenda

    Em campos adicionais

    Máximo de 1024 caracteres. Não disponível para áudio nem figurinha.

    Aparece em:
    Enviar mídia
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Nome do arquivo

    Em campos adicionais

    Nome do arquivo (opcional, para documentos).

    Aparece em:
    Enviar mídia
    Exemplo:
    Exemplo de atendimento

  • Tipo de mensagem interativa

    Obrigatório conforme a operação

    Escolhe uma das opções aceitas por este campo.

    Aparece em:
    Enviar mensagem interativa
    Opções:
    Botões de resposta · Lista
    Padrão:
    Botões de resposta

  • Texto principal

    Obrigatório conforme a operação

    Máximo de 1024 caracteres com botões de resposta e de 4096 com lista.

    Aparece em:
    Enviar mensagem interativa
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Botões de resposta

    Obrigatório conforme a operação

    Lista JSON de botões de resposta (até 3; título com até 20 caracteres).

    Aparece em:
    Enviar mensagem interativa
    Exemplo:
    [{"type":"reply","reply":{"id":"sim","title":"Sim"}}]

  • Texto do botão da lista

    Obrigatório conforme a operação

    Texto do botão que abre a lista (até 20 caracteres).

    Aparece em:
    Enviar mensagem interativa
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Seções da lista

    Obrigatório conforme a operação

    Lista JSON de seções (até 10 seções e 10 opções no total).

    Aparece em:
    Enviar mensagem interativa
    Exemplo:
    [{"title":"Seção","rows":[{"id":"r1","title":"Opção 1"}]}]

  • Texto do cabeçalho

    Em campos adicionais

    Máximo de 60 caracteres.

    Aparece em:
    Enviar mensagem interativa
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Texto do rodapé

    Em campos adicionais

    Máximo de 60 caracteres.

    Aparece em:
    Enviar mensagem interativa
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • ID da mensagem

    Obrigatório conforme a operação

    Informa o identificador exato do recurso na plataforma conectada.

    Aparece em:
    Enviar reação, Marcar como lida
    Exemplo:
    id-do-recurso

  • Emoji

    Define a reação enviada à mensagem; deixe vazio somente quando a operação permitir remover a reação.

    Aparece em:
    Enviar reação
    Exemplo:
    👍

  • Mostrar indicador de digitação

    Em campos adicionais

    Mostra ao remetente que você está digitando. O aviso some quando você responde ou depois de 25 segundos.

    Aparece em:
    Marcar como lida
    Opções:
    Não · Sim
    Padrão:
    Não

  • ID do número de telefone do WhatsApp

    Obrigatório

    ID do número de telefone do seu WhatsApp Business.

    Exemplo:
    id-do-recurso

  • Token de acesso

    ObrigatórioDado protegido

    Token de acesso da API do seu WhatsApp Business.

    Padrão:
    Segredo protegido

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <whatsapp.success>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<whatsapp.success>booleanIndica se o envio foi concluído com sucesso.
<whatsapp.messageId>stringIdentificador da mensagem no WhatsApp.
<whatsapp.messageStatus>stringStatus do ritmo de envio retornado pela API: accepted, held_for_quality_assessment ou paused. Mensagem aceita não significa mensagem entregue — use o gatilho de webhook para acompanhar a entrega.
<whatsapp.messagingProduct>stringProduto de mensagens retornado pela API de envio.
<whatsapp.inputPhoneNumber>stringTelefone do destinatário devolvido pela API de envio.
<whatsapp.whatsappUserId>stringID de usuário do WhatsApp identificado para o destinatário.
<whatsapp.contacts>arrayContatos do destinatário retornados pela API de envio (cada item traz input e wa_id).
<whatsapp.mediaId>stringID da mídia carregada no WhatsApp, ou o ID da mídia baixada.
<whatsapp.file>fileMídia baixada do WhatsApp, salva como arquivo do fluxo.
<whatsapp.fileName>stringNome do arquivo carregado no WhatsApp.
<whatsapp.mimeType>stringTipo MIME da mídia carregada ou baixada.
<whatsapp.size>numberTamanho em bytes do arquivo carregado no WhatsApp.
<whatsapp.fileSize>numberTamanho em bytes da mídia baixada.
<whatsapp.sha256>stringHash SHA-256 informado pelo WhatsApp para a mídia baixada.
<whatsapp.eventType>stringClassificação do webhook, como incoming_message, message_status ou mixed.
<whatsapp.from>stringTelefone do remetente da primeira mensagem recebida.
<whatsapp.recipientId>stringTelefone do destinatário da primeira atualização de status do lote.
<whatsapp.phoneNumberId>stringID do número de telefone da empresa na primeira mensagem ou atualização de status do lote.
<whatsapp.displayPhoneNumber>stringNúmero de telefone exibido da empresa na primeira mensagem ou atualização de status do lote.
<whatsapp.text>stringTexto da primeira mensagem de texto recebida.
<whatsapp.timestamp>stringData e hora da primeira mensagem ou atualização de status do lote.
<whatsapp.messageType>stringTipo da primeira mensagem recebida no lote, como text, image ou system.
<whatsapp.mediaMimeType>stringTipo MIME da primeira mensagem de mídia recebida no lote do webhook.
<whatsapp.caption>stringLegenda da primeira imagem, vídeo ou documento recebido.
<whatsapp.status>stringPrimeiro status de mensagem enviada no lote, como sent (enviada), delivered (entregue) ou read (lida).
<whatsapp.contact>jsonPrimeiro contato remetente no lote do webhook (wa_id, profile.name).
<whatsapp.messages>jsonTodas as mensagens recebidas no lote do webhook, reunidas de todos os entries/changes.
<whatsapp.statuses>jsonTodas as atualizações de status de mensagens do lote do webhook, reunidas de todos os entries/changes.
<whatsapp.webhookContacts>jsonTodos os perfis de contato dos remetentes no lote do webhook.
<whatsapp.conversation>jsonMetadados da conversa na primeira atualização de status do lote (id, expiration_timestamp, origin.type).
<whatsapp.pricing>jsonMetadados de preço da primeira atualização de status do lote (billable, pricing_model, category).
<whatsapp.raw>jsonDados completos do evento do webhook do WhatsApp.
<whatsapp.error>stringInformações do erro, se o envio falhar.

Exemplo de uso

Objetivo: Enviar uma confirmação ao cliente ou à equipe no canal correto.

InícioWhatsApppróxima etapa
Operação
Enviar mensagem
ID do número de telefone do WhatsApp
id-do-recurso
Telefone do destinatário
+5511999999999
Mensagem
Olá! Sua solicitação foi processada com sucesso.

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <whatsapp.success>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Credencial ausente ou recusada
Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.
O serviço recusou a chamada ou devolveu erro
Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

Blocos relacionados