Conecta-seEntrar na plataforma

Texto simples

Enviar uma mensagem de texto pelo WhatsApp (Z-API) dentro de um fluxo de conversa.

Lógica e processamentoComunicaçãoConexão: Sem conexão externa obrigatória

O que faz

Envia uma mensagem de texto pelo WhatsApp (Z-API, rota send-text) e segue sem esperar resposta.

Quando usar: Use quando o seu fluxo precisar enviar uma mensagem de texto pelo WhatsApp (Z-API) dentro de um fluxo de conversa.

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

Antes de começar

Conexão necessária: Sem conexão externa obrigatória.

Nenhuma conta externa é obrigatória para usar este bloco.

Passo a passo

  1. Adicione Texto simples ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Nenhuma conta externa é obrigatória para usar este bloco.
  3. Revise a ação principal descrita no cartão do bloco.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Campos

  • Mensagem

    Obrigatório

    Aceita variáveis e a formatação do WhatsApp (*negrito*, _itálico_). Acima de 4096 caracteres o WhatsApp pode cortar.

    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Mostrar prévia de link

    Ativa ou desativa este comportamento.

    Padrão:
    false

  • Endereço do link

    Informa o endereço seguro do serviço ou recurso que será acessado.

    Quando aparece:
    Quando o campo “Mostrar prévia de link” for “true”
    Exemplo:
    https://api.exemplo.com/v1/recurso

  • Título da prévia

    Define o nome ou título usado para identificar o recurso.

    Quando aparece:
    Quando o campo “Mostrar prévia de link” for “true”
    Exemplo:
    https://api.exemplo.com/v1/recurso

  • Descrição da prévia

    Informa o conteúdo de texto que será enviado ou processado.

    Quando aparece:
    Quando o campo “Mostrar prévia de link” for “true”
    Exemplo:
    https://api.exemplo.com/v1/recurso

  • Imagem da prévia (https)

    Endereço https da imagem mostrada na prévia do link. Se ficar vazio, a mensagem sai como texto simples, sem prévia.

    Quando aparece:
    Quando o campo “Mostrar prévia de link” for “true”
    Exemplo:
    https://api.exemplo.com/v1/recurso

  • Juntar com o próximo texto

    Textos seguidos com esta opção saem numa mensagem só, o que poupa a fila do número.

    Padrão:
    false

  • Citar a última mensagem do cliente

    Em campos adicionais

    Informa o conteúdo de texto que será enviado ou processado.

    Padrão:
    false

  • Atraso antes de enviar (segundos)

    Em campos adicionais

    Informa o conteúdo de texto que será enviado ou processado.

    Padrão:
    0
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Digitando… (segundos)

    Em campos adicionais

    Quantos segundos o WhatsApp mostra “digitando…” para o cliente antes de a mensagem chegar (0 a 15). Deixa a conversa mais natural; 0 envia na hora.

    Padrão:
    0

  • Validade da mensagem

    Em campos adicionais

    Se a mensagem não sair até esse prazo (por exemplo, com o celular desconectado), ela é cancelada.

    Padrão:
    {"amount":10,"unit":"minutes"}

  • Confirmar envio antes de seguir

    Em campos adicionais

    Ligado, o bloco espera a Z-API aceitar a mensagem (até 30 s) e manda falhas de envio para a saída Erro.

    Padrão:
    false

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

ReferênciaTipoO que contém
<textosimples.messageId>stringIdentificador da mensagem na Conecta-se.
<textosimples.providerMessageId>stringIdentificador da mensagem na Z-API.
<textosimples.zaapId>stringIdentificador da fila da Z-API.

Exemplo de uso

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

InícioTexto simplespróxima etapa
Mensagem
Olá! Sua solicitação foi processada com sucesso.
Canal
Envia pelo WhatsApp desta conversa (instância Z-API do canal). Nada de token aqui.
Mostrar prévia de link
false
Endereço do link
https://api.exemplo.com/v1/recurso
Título da prévia
https://api.exemplo.com/v1/recurso
Descrição da prévia
https://api.exemplo.com/v1/recurso

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

Blocos relacionados