Enviar para lista

Enfileirar texto ou mídia 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

Z-API · Envie texto ou mídia para até 1.000 números, com fila e registro por destinatário.

Quando usar: Use quando o seu fluxo precisar enfileirar texto ou mídia 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 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
Configure a conexão WhatsApp, o destinatário e o conteúdo no formulário de envio. Para mídia, anexe o arquivo ou selecione a saída de uma etapa anterior. No teste, confira a prévia simulada; publicar e executar enfileira o envio real. 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 <enviarparalista.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
`<enviarparalista.status>`	string	Enfileirado não significa entregue. Acompanhe a confirmação no histórico.
`<enviarparalista.messageId>`	string	Identificador real da mensagem enfileirada; não é criado no teste.
`<enviarparalista.conversationId>`	string	Conversa criada ou utilizada no envio publicado.
`<enviarparalista.deliveryStatus>`	string	Estado do envio. Enfileirado não significa entregue.
`<enviarparalista.simulated>`	boolean	Verdadeiro somente no teste, sem envio externo.
`<enviarparalista.preview>`	json	Dados resolvidos da simulação: message, recipient e channel. Não confirma entrega.
`<enviarparalista.recipientCount>`	number	Quantidade de destinatários enfileirados.
`<enviarparalista.delivered>`	boolean	Indica se há confirmação de entrega; enfileirar não confirma entrega.
`<enviarparalista.contentSha256>`	string	Identificador de auditoria do conteúdo enfileirado.
`<enviarparalista.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 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 <enviarparalista.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.