Skip to main content
GET
/
user
/
contacts
Listar Contatos
curl --request GET \
  --url https://api.example.com/user/contacts

​
Descricao

Retorna a lista completa de contatos salvos na conta do WhatsApp conectada.

​
Request

​
Headers

token: SEU_TOKEN

​
Response

​
Sucesso (200)

{
  "code": 200,
  "data": {
    "[email protected]": {
      "BusinessName": "",
      "FirstName": "Joao",
      "Found": true,
      "FullName": "Joao Silva",
      "PushName": "Joao"
    },
    "[email protected]": {
      "BusinessName": "Empresa X",
      "FirstName": "",
      "Found": true,
      "FullName": "",
      "PushName": "Empresa X"
    }
  },
  "success": true
}

​
Campos da Resposta

CampoTipoDescricao
BusinessNamestringNome comercial (se business)
FirstNamestringPrimeiro nome
FoundbooleanSe o contato foi encontrado
FullNamestringNome completo
PushNamestringNome definido pelo usuario no WhatsApp

​
Exemplo cURL

curl -X GET 'https://api.bliper.ai/user/contacts' \
  -H 'token: SEU_TOKEN'

​
Casos de Uso

  • Sincronizar contatos com CRM
  • Listar contatos para campanhas
  • Backup de contatos
A lista retorna apenas contatos sincronizados com a conta do WhatsApp, nao os contatos do telefone.
O campo PushName e o nome que o usuario definiu para si mesmo no WhatsApp, independente de como voce salvou o contato.