Enviar modelo para lista

Enviar um modelo aprovado pelo WhatsApp oficial para uma lista de até 1.000 destinatários com registro individual.

Integrações e ferramentasComunicaçãoConexão: Conexão do workspace ou do canal

O que faz

WhatsApp oficial · Envie um modelo aprovado para até 1.000 números, com fila e registro por destinatário.

Quando usar: Use quando o seu fluxo precisar enviar um modelo aprovado pelo WhatsApp oficial para uma lista de até 1.000 destinatários com registro individual.

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

Antes de começar

Conexão necessária: Conexão do workspace ou do canal.

Confirme que a integração ou o canal já está conectado no workspace.

Passo a passo

Adicione Enviar modelo para lista ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
Confirme que a integração ou o canal já está conectado no workspace.
Revise a ação principal descrita no cartão do bloco.
Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
Só publique depois de conferir o resultado da execução de teste.

Campos

Envio pelo WhatsApp
Obrigatório
Escolha o número do WhatsApp oficial, a lista de destinatários, o nome do modelo aprovado na Meta, o idioma e as variáveis, uma por linha na ordem {{1}}, {{2}}. O modelo chega mesmo com a janela de 24 horas fechada. Enfileirado não confirma entrega.

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 <enviarmodeloparalista.status>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

Referência	Tipo	O que contém
`<enviarmodeloparalista.status>`	string	Enfileirado não significa entregue. Acompanhe a confirmação no histórico.
`<enviarmodeloparalista.messageId>`	string	Identificador real da mensagem enfileirada; não é criado no teste.
`<enviarmodeloparalista.conversationId>`	string	Conversa criada ou utilizada no envio publicado.
`<enviarmodeloparalista.deliveryStatus>`	string	Estado do envio. Enfileirado não significa entregue.
`<enviarmodeloparalista.simulated>`	boolean	Verdadeiro somente no teste, sem envio externo.
`<enviarmodeloparalista.preview>`	json	Dados resolvidos da simulação: message, recipient e channel. Não confirma entrega.
`<enviarmodeloparalista.recipientCount>`	number	Quantidade de destinatários enfileirados.
`<enviarmodeloparalista.delivered>`	boolean	Indica se há confirmação de entrega; enfileirar não confirma entrega.
`<enviarmodeloparalista.contentSha256>`	string	Identificador de auditoria do conteúdo enfileirado.
`<enviarmodeloparalista.deduplicated>`	boolean	Indica reutilização de uma mensagem já enfileirada, sem duplicar o envio.

Exemplo de uso

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

InícioEnviar modelo para listapróxima etapa

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 <enviarmodeloparalista.status>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
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.