Conecta-seEntrar na plataforma

Modelo aprovado (oficial)

Enviar pelo WhatsApp oficial um modelo aprovado pela Meta, mesmo com a janela de 24 horas fechada, com uma saída por botão.

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

O que faz

Envia um modelo aprovado pela Meta pelo WhatsApp oficial (Cloud API ou Gupshup), mesmo com a janela de 24 horas fechada. Cada botão de resposta rápida do modelo vira uma saída do bloco.

Quando usar: Use quando o seu fluxo precisar enviar pelo WhatsApp oficial um modelo aprovado pela Meta, mesmo com a janela de 24 horas fechada, com uma saída por botão.

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 Modelo aprovado (oficial) 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

  • Nome do modelo na Meta

    Obrigatório

    Exatamente como aparece na lista de modelos: letras minúsculas, números e _.

    Exemplo:
    Exemplo de atendimento

  • Idioma do modelo

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

    Opções:
    Português (Brasil) · Português (Portugal) · Inglês (EUA) · Espanhol
    Padrão:
    Português (Brasil)

  • Texto do modelo (opcional)

    Cole o texto aprovado para ver a prévia no simulador e no histórico. Não muda o que a Meta envia.

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

  • Variáveis do modelo

    Uma por linha, na ordem {{1}}, {{2}}… Aceita variáveis do fluxo.

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

  • Botões de resposta rápida

    Na mesma ordem e com o mesmo texto dos botões do modelo. Cada botão vira uma saída. Sem botões, o fluxo segue pela próxima etapa.

    Exemplo:
    { "chave": "valor" }

  • Tentativas

    Quantas vezes a mensagem de resposta inválida é enviada antes de seguir pela saída Inválida.

    Padrão:
    2
    Exemplo:
    10

  • Mensagem de resposta inválida

    Use {tentativa} para o número da tentativa e {opcoes} para repetir as opções.

    Padrão:
    Não entendi sua resposta. Escolha uma das opções: {opcoes}
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Sem resposta em

    Depois desse tempo sem resposta, o fluxo segue pela saída Sem resposta. Zero espera até a validade da sessão.

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

  • Aceitar texto livre

    Cria a saída Outra resposta para mensagens que não casam com nenhuma opção.

    Padrão:
    false

  • Salvar resposta em

    Nome da variável do fluxo que guarda a resposta.

    Exemplo:
    nomeDaVariavel

  • 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.

  • 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 <modeloaprovadooficial.escolha>: 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
<modeloaprovadooficial.escolha>jsonOpção escolhida: id, rotulo, numero, texto e casadoPor.
<modeloaprovadooficial.messageId>stringIdentificador da mensagem na Conecta-se.
<modeloaprovadooficial.providerMessageId>stringIdentificador da mensagem na Z-API.
<modeloaprovadooficial.zaapId>stringIdentificador da fila da Z-API.

Exemplo de uso

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

InícioModelo aprovado (oficial)próxima etapa
Nome do modelo na Meta
Exemplo de atendimento
Canal
Só para números do WhatsApp oficial. O modelo precisa estar aprovado na Meta (Atendimento…
Idioma do modelo
Português (Brasil)
Texto do modelo (opcional)
Olá! Sua solicitação foi processada com sucesso.
Variáveis do modelo
Olá! Sua solicitação foi processada com sucesso.
Botões de resposta rápida
{ "chave": "valor" }

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

Blocos relacionados