POST
/
wa
/
instances
/
{instance_id}
/
recipients
/
batch
curl --request POST \
  --url https://api.zapsterapi.com/v1/wa/instances/{instance_id}/recipients/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "recipients": [
    "<string>"
  ]
}'
[
  {
    "exists": true,
    "error": {
      "code": "recipient_not_found",
      "message": "The specified recipient could not be found."
    },
    "id": "<string>",
    "is_business": true,
    "name": "<string>",
    "profile_picture": "https://zapsterapi.s3.us-east-1.amazonaws.com/...",
    "original": "551112341234"
  }
]

​
Introdução

Este endpoint é similar ao Verificação de Número, mas permite a verificação de até 100 números em uma única requisição, o que é ideal para quando você precisa verificar a existência de múltiplos números de WhatsApp de forma eficiente.

Para garantir o melhor uso dessa rota, por favor, consulte os Pontos de Atenção, onde explicamos algumas nuances importantes sobre o name e profile_picture.

​
Como funciona?

A resposta desse endpoint será sempre uma lista de objetos, onde cada objeto representará o status de um número enviado na requisição.

Cada número consultado será avaliado quanto à sua existência no WhatsApp e se o número corresponde a uma conta de WhatsApp Business. Além disso, caso o número seja inválido ou não encontrado, a resposta fornecerá detalhes sobre o erro.

Vamos supor que você informe dois números para a consulta. Se um dos números existir e o outro não, a resposta será algo parecido com o seguinte exemplo:

Exemplo de Resposta
[
  {
    "exists": true,
    "id": "551112341234",
    "is_business": false,
    "original": "551112341234",
    "profile_picture": "https://zapsterapi.s3.us-east-1.amazonaws.com/..."
  },
  {
    "error": {
      "code": "recipient_not_found",
      "message": "The specified recipient could not be found."
    },
    "exists": false,
    "original": "5511998765432"
  }
]

​
Diferença entre original e id

Em alguns casos, o número informado na lista de consulta pode ser ajustado pelo WhatsApp. Isso geralmente acontece devido a variações regionais, como a inclusão ou exclusão do nono dígito para números de celular no Brasil. O campo original serve para garantir que você veja exatamente o número que foi enviado na sua requisição, enquanto o campo id mostra o número que o WhatsApp conseguiu encontrar após eventuais ajustes.

​
Como Funciona?

  • original: É o número exatamente como você o enviou na requisição, sem nenhuma alteração.
  • id: É o número ajustado ou resolvido pelo WhatsApp, que pode ser diferente do original caso o WhatsApp tenha encontrado uma versão corrigida.

A seguir, mostramos três exemplos que ilustram diferentes cenários de consulta de números, usando os campos original e id.

{
  "exists": true
  "id": "5511998765432",
  "original": "5511998765432",
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
instance_id
string
required

Obrigatório se instance_id não estiver presente no body.

Body

application/json

Response

200 - application/json

Success

The response is of type object[].