Consulta Status

Veja detalhes de como consultar o status de uma ou mais mensagens.

A partir deste serviço você poderá consultar o status individual ou em lote das mensagens enviadas via API. Recomendável para situações onde o recebimento por webhook tenha falhado por algum motivo.

Para que evite-se requisições desnecessárias recomendamos o registro de endpoint como webhook. Dessa forma, logo que recebermos atualizações dos status das mensagens do aplicativo, elas serão repassadas ao seu endpoint imediatamente.

Fique atento quanto ao rate-limit de requisições para o correto funcionamento da API.

Consulta individual

GET https://api-v2.smsfire.com.br/whatsapp/status/:id

Informe o id da mensagem que é dado no callback das requisições ou então customId que é informado na requisição de envio da mensagem.

Atenção: Campos com * (asterisco) são obrigatórios

Path Parameters

Name	Type	Description
id*	string	id ou customId da mensagem. (Max. 40 caracteres)

Headers

Name	Type	Description
Authorization*	string	Basic <Token>

200 Objeto JSON

{
  "instanceToken": "499893c21b1b467970b2n58dcak6009d92d9dscx1",
  "id": 000001,
  "messageType": "TEXT",
  "country": "55",
  "phone": "5511944556677",
  "statusCode": 2,
  "statusName": "DELIVERED",
  "statusDate": "2021-08-06T09:59:02-0300",
  "sentDate": "2021-08-06T09:58:53-0300"
}

Exemplo de requisição

• Consulta por id

GET - https://api-v2.smsfire.com.br/whatsapp/status/000001

• Consulta por customId

GET - https://api-v2.smsfire.com.br/whatsapp/status/firezap0001

Consulta múltipla

POST https://api-v2.smsfire.com.br/whatsapp/status/search

Realize consulta de múltiplas mensagens ao informar seus respectivos id e/ou customId

Atenção: Campos com * (asterisco) são obrigatórios

Headers

Name	Type	Description
Authorization*	string	Basic <Token>
Content-Type*	string	application/json

Request Body

Name	Type	Description
customIds	array	customId das mensagens
ids	array	Id das mensagens

200

[
  {
    "instanceToken": "499893c21b1b467970b2n58dcak6009d92d9dscx1",
    "id": 0001,
    "messageType": "TEXT",
    "country": "55",
    "phone": "5511944556677",
    "statusCode": 5,
    "statusName": "EXPIRED",
    "statusDate": "2021-08-03T18:18:36-0300",
    "sentDate": "2021-08-03T18:18:33-0300"
  },
  {
    "instanceToken": "499893c21b1b467970b2n58dcak6009d92d9dscx1",
    "id": 00002,
    "customId":"firezap0002",
    "messageType": "TEXT",
    "country": "55",
    "phone": "5511966778899",
    "statusCode": 2,
    "statusName": "DELIVERED",
    "statusDate": "2021-08-03T19:39:01-0300",
    "sentDate": "2021-08-03T19:32:10-0300"
  }
]

Exemplo de requisição

curl --request POST \
  --url https://api-v2.smsfire.com.br/whatsapp/status/search \
  --header 'Authorization: Basic <TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{ "ids": ["0001"],	"customIds":["firezap0002"] }'

Os parâmetros ids e customIds são independentes, ou seja, você poderá consultar mensagens informando valores distintos em cada um deles ou em apenas um deles.

A consulta retornará no máximo 200 itens.

Campos JSON do status

Detalhamento dos tipos de cada um dos campos dados no response das consultas individuais ou múltiplas

A API retornará o código HTTP 204 No Content quando não encontrar a mensagem pesquisada e o corpo da resposta será vazio.

Campo	Tipo	Descrição
instanceToken	string	Token da instância vinculada a mensagem
id	int	Id da mensagem
customId	string	Id personalizado fornecido pelo cliente. Parâmetro será omitido quando não informado no envio da mensagem
messageType	string	Tipo da mensagem enviada podendo ser: TEXT IMAGE VIDEO AUDIO DOCUMENT LOCATION STICKER
country	string	Prefixo do país do destinatário
phone	string	Telefone do destinatário em formato internacional
statusCode	int	Código do status atual da mensagem
statusName	string	Nome do status atual da mensagem
statusDate	string	Data da última atualização do status (ISO8601)
sentDate	string	Data do envio da mensagem (ISO8601)

A formatação do JSON apresentada neste serviço é exatamente a mesma da que enviaremos via Webhooks em Callback ou DLR quando configurados.

Acesse a página Código de status para ter informações detalhadas sobre cada um dos códigos fornecidos pelo serviço.