1. Mensagens
  • Raiz
    • Webhooks
      • Criar ou atualizar webhook
      • Desativar webhook
    • Instâncias
      • Listar instâncias
      • Criar instância
      • Atualizar nome da instância
      • Remover instância
      • Listar chats da instância
      • Conectar instância
      • Desconectar instância
      • Consultar detalhes de grupo
      • Listar newsletters inscritas
      • Consultar detalhes de newsletter
      • Consultar último QR code da instância
      • Consultar status da instância
    • Mensagens
      • Enviar mensagem com imagem
        POST
      • Enviar mensagem com prévia de link
        POST
      • Listar mensagens pendentes
        GET
      • Cancelar mensagens pendentes
        DELETE
      • Enviar mensagem de texto
        POST
  • Esquemas
    • OrderedInboundWebhookPayloadBase
  1. Mensagens

Listar mensagens pendentes

Amb. de Produção
https://api.way-api.io
Amb. de Produção
https://api.way-api.io
GET
/instances/{instanceId}/messages/pending
Última modificação:2026-09-17 22:00:23
Lista as mensagens da instância que ainda não começaram a ser enviadas.
A lista vem da mais antiga para a mais recente. O campo total informa a quantidade total de mensagens
pendentes, mesmo quando limit reduz o número de itens retornados.

Requisição

Authorization
Adicionar parâmetro em header
x-api-key
Exemplo:
x-api-key: ********************
Parâmetros de Caminho

Parâmetros de Consulta

Parâmetros Header

Respostas

🟢200OK
application/json
Resposta com as mensagens que ainda estão esperando para sair desta instância.
Bodyapplication/json

🟠400Requisição Inválida
🟠401Não Autorizado
🟠403Proibido
🟠404Registo Não Encontrado
🟠429
🔴500Erro do Servidor
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.way-api.io/instances//messages/pending?limit=undefined' \
--header 'x-api-key: <api-key>'
Response Response Example
200 - Fila com mensagens pendentes
{
    "instanceId": "018f47ac-7a5b-7cc2-9f9a-9b8d7f6e5d4c",
    "total": 2,
    "messages": [
        {
            "id": "018f47ac-7a5b-7cc2-9f9a-9b8d7f6e5d4c",
            "remoteJid": "120363123456789@g.us",
            "type": "text",
            "status": "queued",
            "scheduledTo": "2026-04-23T12:34:56.000Z",
            "createdAt": "2026-04-23T12:30:00.000Z",
            "updatedAt": "2026-04-23T12:30:00.000Z"
        },
        {
            "id": "018f47ac-7a5b-7cc2-9f9a-9b8d7f6e5d4d",
            "remoteJid": "120363987654321@g.us",
            "type": "image",
            "status": "queued",
            "scheduledTo": null,
            "createdAt": "2026-04-23T12:31:00.000Z",
            "updatedAt": "2026-04-23T12:31:00.000Z"
        }
    ]
}
Modificado em 2026-09-17 22:00:23
Página anterior
Enviar mensagem com prévia de link
Próxima página
Cancelar mensagens pendentes
Built with