Pular para o conteúdo principal

Fila

Método#

/queue#

GET https://api.z-api.io/instances/SUA_INSTANCIA/token/SEU_TOKEN/queue

Header#

KeyValue
Client-TokenTOKEN DE SEGURANÇA DA CONTA

Conceituação#

Este método é responsável por retornar todas mensagens que estão em sua fila aguardando para ser processada.


Atributos#

Obrigatórios#

AtributosTipoDescrição
pageintegerUtilizado para paginação você de informar aqui a pagina de mensagens que quer buscar
pageSizeintegerEspecifica o tamanho do retorno de mensagens por pagina

Opcionais#

AtributosTipoDescrição
countstringAtributo utilizado para retornar o número de mensagens na fila

Request Params#

URL exemplo#

Método

GET https://api.z-api.io/instances/SUA_INSTANCIA/token/SEU_TOKEN/queue?page=1&pageSize=100

ou

GET https://api.z-api.io/instances/SUA_INSTANCIA/token/SEU_TOKEN/queue/count


Response#

200#

AtributosTipoDescrição
messagesarray stringArray com as menssagens da fila

Array Messages

AtributosTipoDescrição
_idstringID da mensagem no Z-API
DelayMessagestringTempo em segundos entre o envio das mensagens
MessagestringTexto da Mensagem
IsTrialbooleanIndica se a instância está utilizando trial
InstanceIdstringID da instância
PhonestringNúmero do destinatário
ZaapIdstringID da mensagem no Z-API
DelayTypingstringDuração do indicador do chat "digitando..."
MessageIdstringID da mensagem
CreatedtimetampData da mensagem

Exemplo

{
[
{
"_id": "39BB1684570F00E91090F6BBC7EE7646",
"DelayMessage": -1,
"Message": "Mensagem da fila 1",
"IsTrial": false,
"InstanceId": "3A5D07856DC26A1C9E2E08E691E63271",
"Phone": "5511999999999",
"ZaapId": "39BB1684570F00E91090F6BBC7EE7646",
"DelayTyping": 0,
"MessageId": "7AD29EAA5EF34C301F0B",
"Created": 1624977905648,
},
{
"_id": "39BB1684570F00E91090F6BBC7EE7646",
"DelayMessage": -1,
"Message": "Mensagem da fila 2",
"IsTrial": false,
"InstanceId": "3A5D07856DC26A1C9E2E08E691E63271",
"Phone": "5511999999999",
"ZaapId": "39BB1684570F00E91090F6BBC7EE7646",
"DelayTyping": 5,
"MessageId": "7AD29EAA5EF34C301F0B",
"Created": 1624977906907,
}
]
}

405#

Neste caso certifique que esteja enviando o corretamente a especificação do método, ou seja verifique se você enviou o POST ou GET conforme especificado no inicio deste tópico.

415#

Caso você receba um erro 415, certifique de adicionar na headers da requisição o "Content-Type" do objeto que você está enviando, em sua grande maioria "application/json"


Code#