Enviar documento

Enfileirar um documento no WhatsApp conectado.

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

O que faz

Z-API · Anexe um PDF, documento ou planilha.

Quando usar: Use quando o seu fluxo precisar enfileirar um documento no WhatsApp conectado.

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 documento 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 <enviardocumento.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
`<enviardocumento.status>`	string	Enfileirado não significa entregue. Acompanhe a confirmação no histórico.
`<enviardocumento.messageId>`	string	Identificador real da mensagem enfileirada; não é criado no teste.
`<enviardocumento.conversationId>`	string	Conversa criada ou utilizada no envio publicado.
`<enviardocumento.deliveryStatus>`	string	Estado do envio. Enfileirado não significa entregue.
`<enviardocumento.simulated>`	boolean	Verdadeiro somente no teste, sem envio externo.
`<enviardocumento.preview>`	json	Dados resolvidos da simulação: message, recipient e channel. Não confirma entrega.
`<enviardocumento.recipientCount>`	number	Quantidade de destinatários enfileirados.
`<enviardocumento.delivered>`	boolean	Indica se há confirmação de entrega; enfileirar não confirma entrega.
`<enviardocumento.contentSha256>`	string	Identificador de auditoria do conteúdo enfileirado.
`<enviardocumento.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 documentopró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 <enviardocumento.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.