Confirmar canal, ticket e janela

Botões e listas WABA são mensagens interativas livres. Use essas rotas somente em um ticket do canal oficial durante a janela de 24 horas contada desde a última interação do contato. Quando a janela estiver encerrada, inicie ou retome a conversa com um template aprovado.

Menu Mais opções do atendimento com Templates, Botões e Lista na seção WABA
As ações WABA aparecem no ticket, mas sua disponibilidade depende do canal e da janela da conversa.
  1. 1

    Consulte o ticket e confirme que ele pertence à conexão oficial usada pela credencial.

  2. 2

    Verifique se o contato respondeu dentro da janela exibida no atendimento.

  3. 3

    Confirme que number corresponde ao contato do ticketId.

  4. 4

    Comece por uma interação simples e um único destinatário de homologação.

Enviar até três botões de resposta

A operação publicada é POST /v2/api/external/{ApiID}/sendButtonWABA.

  • number é publicado como string e identifica o destinatário.
  • message é publicado como string e contém o texto principal.
  • button1, button2 e button3 são strings para os rótulos das opções.
  • ticketId é publicado como número e identifica o atendimento que receberá a mensagem.
  1. 1

    Use uma pergunta curta e opções que não se sobreponham.

  2. 2

    Garanta que cada rótulo indique claramente o resultado da escolha.

  3. 3

    Envie somente uma requisição no primeiro teste.

  4. 4

    Abra o ticket e confira ordem, texto, renderização e resposta selecionada.

Enviar uma lista com seções e linhas

A operação publicada é POST /v2/api/external/{ApiID}/sendListWABA.

  • number e ticketId devem representar o mesmo atendimento controlado.
  • header, body e footer estruturam o conteúdo visível.
  • button_text define o texto que abre a lista.
  • sections[] agrupa as opções; cada seção publica title e rows[].
  • Cada item de rows[] publica id, title e description.

Usar template quando a janela estiver encerrada

Aviso de janela de 24 horas encerrada e botão Enviar Template
Fora da janela, use um template aprovado; botões ou listas livres não substituem esse fluxo.
  1. 1

    Interrompa o envio interativo quando o ticket indicar janela encerrada.

  2. 2

    Selecione um template aprovado no nome e idioma corretos.

  3. 3

    Envie o template pela família própria de rotas.

  4. 4

    Aguarde e confirme a resposta do contato.

  5. 5

    Somente então use uma mensagem interativa livre no ticket correspondente.

Validar a interação e resolver falhas

Histórico de um ticket de teste com uma mensagem enviada
Use o histórico para confirmar se a interação foi registrada ou processada no ticket antes de repetir uma requisição que apresentou timeout.
  • Interação recusada: confira janela, canal oficial, ticketId e number.
  • Botões não aparecem: revise nomes dos campos, rótulos e limites atuais.
  • Lista inválida: confira sections, rows, aninhamento e IDs inequívocos na lógica do consumidor.
  • Número recusado: use o formato aceito pelo canal; essas rotas não publicam validateNumber.
  • Resposta não é reconhecida: inspecione o evento ou payload realmente recebido pela versão, pois o schema da seleção não está publicado.
  • Timeout: consulte o histórico do ticket antes de reenviar.
  • Duplicidade: suspenda retentativas automáticas e reconcilie o resultado anterior.