Conecta-seEntrar na plataforma

Início da conversa

Começar um fluxo de conversa quando chega uma mensagem do WhatsApp (Z-API) no canal ligado ao fluxo.

Gatilhos de inícioComunicaçãoConexão: Sem conexão externa obrigatória

O que faz

Começa o fluxo quando uma conversa do WhatsApp (Z-API) chega no canal que aponta para este fluxo.

Quando usar: Use quando o seu fluxo precisar começar um fluxo de conversa quando chega uma mensagem do WhatsApp (Z-API) no canal ligado ao fluxo.

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 Início da conversa ao desenho a partir da seção Gatilhos da aba Blocos.
  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

  • Quando iniciar

    Em quais situações este fluxo começa: conversa nova, mensagem sem dono, palavra-chave, fora do horário, resposta a anúncio ou resposta a campanha. Marque uma ou mais.

    Opções:
    Conversa nova · Toda mensagem sem dono · Palavra-chave · Fora do horário de atendimento · Resposta a anúncio · Resposta a campanha
    Padrão:
    {"new_conversation":true}
    Exemplo:
    Conversa nova

  • Palavras-chave

    Usadas quando "Palavra-chave" está marcado. Modo: exata, contém ou regex.

  • Atender grupos

    Ativa ou desativa este comportamento.

    Padrão:
    false

  • Não iniciar com humano atribuído

    Ativa ou desativa este comportamento.

    Padrão:
    true

  • Respeitar o bot congelado

    Ativa ou desativa este comportamento.

    Padrão:
    true

  • Intervalo mínimo entre inícios (minutos)

    Intervalo mínimo, em minutos, entre dois inícios do fluxo para o mesmo contato. Evita recomeçar o fluxo a cada mensagem; 0 desliga.

    Padrão:
    0

  • Validade da sessão

    Tempo máximo que uma conversa fica neste fluxo. Até 7 dias.

    Padrão:
    {"amount":24,"unit":"hours"}

  • Quando a sessão expirar

    Escolhe uma das opções aceitas por este campo.

    Opções:
    Encerrar em silêncio · Enviar uma mensagem · Recomeçar na próxima mensagem
    Padrão:
    Encerrar em silêncio

  • Mensagem ao expirar

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

    Quando aparece:
    Quando o campo “Quando a sessão expirar” for “Enviar uma mensagem”
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Interrupções globais

    Palavras que valem em qualquer ponto do fluxo, como "sair" ou "falar com atendente". Só para texto livre.

  • Se um bloco der erro sem saída Erro ligada

    Escolhe uma das opções aceitas por este campo.

    Opções:
    Transferir para a fila padrão · Devolver ao padrão do canal · Encerrar com uma mensagem
    Padrão:
    Transferir para a fila padrão

  • Mensagem de erro

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

    Quando aparece:
    Quando o campo “Se um bloco der erro sem saída Erro ligada” for “Encerrar com uma mensagem”
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Se uma mensagem não for entregue

    Escolhe uma das opções aceitas por este campo.

    Opções:
    Ignorar e seguir · Ir para um bloco · Encerrar o fluxo
    Padrão:
    Ignorar e seguir

  • Bloco para falha de entrega

    Bloco para onde o fluxo vai quando uma mensagem não pode ser entregue e a política de falha de entrega é “ir para um bloco”.

    Quando aparece:
    Quando o campo “Se uma mensagem não for entregue” for “Ir para um bloco”
    Exemplo:
    (escolha na lista do campo)

  • Congelar o bot quando o atendente responder pelo celular (minutos)

    Identifica a conversa, o canal ou o telefone de destino.

    Padrão:
    30
    Exemplo:
    +5511999999999

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 <iniciodaconversa.startedBy>: 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
<iniciodaconversa.startedBy>stringO que iniciou a sessão: inbound, keyword, switch, restart, automation, operator ou api.
<iniciodaconversa.keyword>stringPalavra-chave que iniciou o fluxo, quando houver.
<iniciodaconversa.message>stringTexto da mensagem que iniciou o fluxo.
<iniciodaconversa.ctwaClid>stringIdentificador do clique no anúncio, quando a conversa veio de um anúncio.

Exemplo de uso

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

Início da conversaprocessamentoação final
Canal
Envia pelo WhatsApp desta conversa (instância Z-API do canal). Nada de token aqui. O cana…
Quando iniciar
Conversa nova
Atender grupos
false
Não iniciar com humano atribuído
true
Respeitar o bot congelado
true

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 <iniciodaconversa.startedBy>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O fluxo não inicia sozinho
Gatilhos só disparam com a automação publicada. Confira também se o evento aconteceu na conta conectada e se os filtros do gatilho não estão excluindo o evento.

Blocos relacionados