ZAP Gateway icon

ZAP Gateway

Envia mensagens WhatsApp via ZAP Gateway (Z-API / UAZAPI)

Actions21

Mensagem → Enviar Mensagem

AI-generated

Summary

Envia uma mensagem WhatsApp pela instância selecionada, escolhendo o tipo de conteúdo e o destino. O envio pode ser texto, mídia, link, reação, enquete, botões, lista de opções, chave PIX ou código OTP; URLs de mídia e link são validadas como HTTP ou HTTPS.

Inputs

  • Instância (required) — Instância WhatsApp configurada no ZAP Gateway; selecione-a na lista carregada pelo nó.
  • Enviar Para (required) — Escolha Número de Telefone ou Grupo. Para telefone, informe de 10 a 15 dígitos ou um ID de grupo terminado em -group ou @g.us. Para Grupo, escolha um grupo na lista da instância.
  • Tipo (required) — Selecione Texto, Imagem, Vídeo, GIF, Áudio, Documento, Link, Reação, Enquete, Botões, Lista de Opções, PIX ou OTP.
  • Conteúdo da mensagem (required) — Os campos dependem do tipo: texto pede Mensagem; imagem, vídeo, GIF e áudio pedem a URL correspondente; documento pede URL e Nome do Arquivo; link pede Texto da Mensagem e URL do Link; reação pede ID da Mensagem e emoji; enquete pede Pergunta e opções separadas por linha, com Máx. Opções Selecionáveis opcional; botões pedem Mensagem e configuração de até três botões; lista pede Mensagem, Rótulo do Botão e opções; PIX pede Chave PIX e Tipo da Chave; OTP pede Mensagem e Código.
  • Campos opcionais por tipo — Legenda para imagem, vídeo, GIF ou documento; título, descrição e imagem do preview para link; título e rodapé para botões; título para lista de opções; Nome do Recebedor para PIX. Botões podem ser de resposta, abrir URL ou ligar; opções da lista aceitam ID e descrição.
  • Opções de Envio — Responder à mensagem por ID, mencionar telefones separados por vírgula, simular digitação por um número de segundos ou marcar imagem/vídeo como visualização única. Menções são convertidas em uma lista.
  • Incluir Resposta Completa — Ative para retornar todos os campos recebidos do gateway; por padrão, a saída mantém apenas campos conhecidos, como success, messageId, provider, timestamp e fallbackUsed.

Output shape

Um item de saída por item de entrada, contendo os campos da resposta do gateway.

Por padrão, a resposta é filtrada para campos conhecidos que estejam presentes. Com Incluir Resposta Completa ativo, a resposta integral do gateway é retornada. Se Continue On Fail estiver ativo, erros são emitidos como {"error":"..."} no item correspondente.

Links

Discussion