TurboZap LogoTurboZap
API/Contatos

Contatos

Verifique números e obtenha informações de contatos

Visão geral

A API de contatos permite verificar se um número possui WhatsApp, obter fotos de perfil e gerenciar a lista de contatos.

Endpoints

POST/contact/:instance/checkVerificar números
GET/contact/:instance/:phone/profile-picFoto de perfil
GET/contact/:instance/:phone/infoInfo do contato
POST/contact/:instance/blockBloquear contato
POST/contact/:instance/unblockDesbloquear contato
GET/contact/:instance/listListar contatos

Verificar número

Verifique se um ou mais números possuem WhatsApp antes de enviar mensagens:

POST/contact/:instance/check
Requisição
{
  "phones": [
    "5511999999999",
    "5511888888888",
    "5511777777777"
  ]
}
Resposta
{
  "success": true,
  "data": {
    "results": [
      {
        "phone": "5511999999999",
        "exists": true,
        "jid": "5511999999999@s.whatsapp.net"
      },
      {
        "phone": "5511888888888",
        "exists": true,
        "jid": "5511888888888@s.whatsapp.net"
      },
      {
        "phone": "5511777777777",
        "exists": false,
        "jid": null
      }
    ]
  }
}

Dica: Sempre verifique os números antes de enviar mensagens em massa para evitar erros e melhorar a taxa de entrega.

Foto de perfil

Obtenha a URL da foto de perfil de um contato:

GET/contact/:instance/:phone/profile-pic
Resposta
{
  "success": true,
  "data": {
    "phone": "5511999999999",
    "profile_pic_url": "https://pps.whatsapp.net/v/t61.24694-24/...",
    "has_profile_pic": true
  }
}

Nota: A URL da foto de perfil é temporária e pode expirar. Faça cache local da imagem se necessário.