Operações do nó Turbo Notify

Esta página lista o que o nó Turbo Notify faz em um fluxo. Para instalar e enviar a primeira mensagem, comece por Use o Turbo Notify no n8n.

Como os campos funcionam

Todo campo aceita um valor fixo, um valor mapeado de um nó anterior ({{ $json.phone }}) ou qualquer outra expressão do n8n. O nó roda uma vez para cada item de entrada: com 200 linhas, ele envia 200 mensagens, cada uma com o seu destinatário e o seu texto.

Number é o número que envia. Escolha na lista, ou escolha By Alias or ID e digite o apelido (main para o número principal) ou o ID num_..., ou mapeie.

Message

Operação	O que faz
Send Text	Envia um texto de até 4096 caracteres. `@5511977770001` (só dígitos, sem `+`) menciona essa pessoa.
Send Media	Envia imagem, vídeo, áudio, documento ou figurinha a partir de um endereço público da web. Legenda para imagem, vídeo e documento, nome do arquivo para documento.
Send Location	Envia uma localização no mapa.
Send Contact Card	Envia um cartão de contato com 1 a 10 telefones e e-mails opcionais. Coloque Phones Input em JSON para passar os telefones como uma lista de um nó anterior, como `{{ $json.phones }}`.
Send Calendar Event	Envia um convite de evento. O WhatsApp mostra o horário só em contas WhatsApp Business. Adicione Remind Before (Minutes) para um lembrete.
Send Link Button	Envia uma mensagem com um botão que abre um link.
Send Typing Indicator	Mostra “digitando” em uma conversa enquanto o fluxo (ou um passo de IA) prepara a resposta, e marca como lidas as mensagens não lidas dessa conversa. Exige o plano Lobo Solitário ou superior.
Reply	Responde a uma mensagem anterior, citando-a. Para responder a uma mensagem vinda de um gatilho, mapeie Message ID para `{{ $json.data.id }}`.
React	Reage com um emoji. Um emoji vazio remove a sua reação. Exige o plano Lobo Solitário ou superior.
Edit Text, Edit Caption	Altera uma mensagem enviada por você, até 15 minutos depois do envio.
Delete	Apaga uma mensagem enviada por você. A saída traz `deleted: true`, que significa que o Turbo Notify aceitou o pedido. O WhatsApp conclui a exclusão um instante depois.
Get Status	Devolve `pending`, `sent`, `delivered`, `read` ou `failed`, com o motivo quando falhou.
`Get Quota`	Quantas mensagens o número ainda pode enviar neste ciclo de cobrança. Rode antes de um envio grande.
Get, Get Many	Lê mensagens. Get Many filtra por grupo, contato e direção.

Quem recebe

O destinatário de um envio é uma destas três coisas:

Phone Number: com o código do país e um + na frente, como +5511977770001.
Contact ou Group: escolhido em uma lista, ou mapeado pelo ID.
Auto-Detect: use quando um valor de um nó anterior pode ser qualquer um dos três. O nó distingue um telefone, um ID ct_ e um ID grp_.

Dígitos sem + são recusados, nunca adivinhados. Monte o valor com {{ '+' + $json.phone }}. Enviar para grupo exige o plano Empresarial ou superior.

Os envios de conteúdo (tudo, menos Send Text) podem citar uma mensagem anterior com Quoted Message ID, em Additional Fields.

O que o nó seguinte recebe

Todo passo de mensagem devolve a resposta da API mais:

id: o ID da mensagem.
number_alias, ou number_id quando você informou um ID num_.... São os mesmos nomes que Get, Get Many e os gatilhos usam.
to: o destinatário como foi enviado, nos envios e no indicador de digitação.

{{ $json.id }} alimenta Get Status, Reply, React, Edit ou Delete depois de qualquer passo de mensagem. Depois de um gatilho, é {{ $json.data.id }}. status é um objeto: use {{ $json.status.state }}.

Os valores da linha de entrada continuam disponíveis com {{ $('Nome do nó anterior').item.json.coluna }}.

Contact, Group, Number e Event

Recurso	Operações
Contact	Get, Get Many. Get Many filtra por nome, telefone, como o contato apareceu pela primeira vez e se você falou com ele no ciclo de cobrança atual.
Group	Get, Get Many. Get Many pode incluir grupos dos quais o número saiu.
Number	Get lê um número com o status da conexão, útil para conferir antes de um envio em massa. Get Many lista o número principal e os extras e filtra por status para achar os que precisam de atenção.
Event	Get Many lê o que aconteceu nos seus números, do mais novo para o mais antigo, filtrado por tipo, número e horário. Use para recuperar eventos que um fluxo perdeu enquanto estava desligado.

Return All, Limit e Simplify

As operações Get Many devolvem um item do n8n por resultado.

Return All segue o cursor da API até não sobrar nada. Sem ele, Limit (50 por padrão) limita o resultado.
Simplify vem ligado e mantém os campos principais (no máximo 10). Desligue para ver os objetos completos. Ele vem ligado também em Get, e uma mensagem simplificada mantém o text.
Um filtro adicionado precisa ser preenchido: um filtro vazio é recusado, em vez de devolver tudo.

Enviar muitas mensagens

Espaçamento. Cada número tem um intervalo mínimo entre envios, que depende do plano. Quando o Turbo Notify responde que uma mensagem veio cedo demais, o nó espera o tempo pedido e tenta de novo, até 3 vezes. Uma cota esgotada nunca é repetida.
Conferência antes. O nó lê e confere todos os itens antes de enviar o primeiro, então uma linha inválida interrompe a execução sem enviar nada. Com Continue On Fail, as outras linhas saem e a inválida informa o que corrigir.
Sem envio em dobro. Retry On Fail, nas configurações do nó, roda o nó inteiro de novo. Por isso, em execuções reais (não quando você clica em Execute step), o nó define uma Idempotency Key sozinho. Ela é igual quando o n8n repete um item e diferente para cada item, então uma repetição dentro da mesma execução nunca envia a mensagem duas vezes.
Sua própria chave. Em Options, Idempotency Key deve ser diferente para cada item, como o número do pedido vindo de um nó anterior. Um valor fixo envia só a primeira mensagem, e o nó recusa uma chave repetida para outra mensagem na mesma execução.
Repetir uma execução. Repetir uma execução no editor cria uma execução nova e envia de novo os itens que já tinham saído.
Número novo. Teste com poucas mensagens: um número conectado hoje envia um volume limitado por dia. A tabela está em Use o Turbo Notify no n8n.

Antes de um envio grande, um passo Number > Get diz se o número está conectado, e Get Quota (em Message) diz quantas mensagens ele ainda pode enviar no ciclo. Planos e cotas estão em Cobrança (abre em nova aba).

Quando um passo para

O nó para com o motivo e o que mudar. Ligue Continue On Fail nas configurações do nó para o fluxo seguir: o item que falhou leva a mensagem em error e o que mudar em hint.

Código	O que fazer
`not_authenticated`	A chave está errada, foi revogada ou expirou. Crie uma nova em API Keys.
`insufficient_scope`	A chave não tem uma permissão. A mensagem diz qual.
`number_not_connected`	Reconecte o número em Números.
`messages_quota_exceeded`, `contact_quota_exceeded`	A franquia do ciclo de cobrança acabou. Ela volta quando o ciclo vira, ou quando você muda de plano em Cobrança.
`warmup_limit_exceeded`	Um número novo atingiu o volume do dia. A mensagem diz quanto falta para a contagem recomeçar, à meia-noite UTC.
`feature_not_available`	O plano não inclui, por exemplo enviar para grupos ou o indicador de digitação.
`edit_window_expired`	Um texto ou legenda só pode ser editado até 15 minutos depois.
`send_rate_spacing`, `rate_limit_exceeded`	Rápido demais para o plano. O nó espera e tenta de novo até 3 vezes antes de parar.

Se o Turbo Notify não puder ser alcançado ou não responder a tempo, a mensagem diz isso. Em um envio, confira Message > Get Many com Direction Sent antes de rodar de novo, porque a mensagem pode ter saído. Todos os códigos estão na referência de erros.