Skip to main content
GET
Este endpoint verifica se existe uma janela de mensagens ativa de 24 horas entre seu remetente WhatsApp e um destinatário específico. Use isto para determinar se você pode enviar mensagens livres ou precisa usar uma mensagem de template.

Parâmetros de Query

integer
required
O ID do remetente WhatsApp (obtido do endpoint Obter Remetentes)
string
required
O número de telefone do destinatário em formato internacional (ex: +1234567890)

Campos da Resposta

boolean
Se a requisição foi bem-sucedida
boolean
Se existe uma conversa com este destinatário
integer
O ID da conversa (presente apenas quando has_conversation é true)
string
O nome do cliente se disponível (presente apenas quando has_conversation é true)
string
Timestamp ISO 8601 da última mensagem do cliente (presente apenas quando has_conversation é true)
object

Respostas de Erro

Fluxo Típico

Use este endpoint como parte de um fluxo de envio de mensagens:
  1. Verificar status da sessão antes de enviar uma mensagem
  2. Se can_send_freeform for true → use Enviar Mensagem Livre
  3. Se requires_template for true → use Enviar Mensagem de Template

Observações

  • A janela de 24 horas é baseada no timestamp da última mensagem recebida do cliente.
  • Cada nova mensagem do cliente reinicia o timer de 24 horas.
  • Este endpoint não consome nenhum saldo — é apenas uma verificação de status somente leitura.