Skip to main content

Endpoint

GET /v1/contacts/:id
Escopo necessário: read:contacts

Parâmetros de path

ParâmetroTipoDescrição
idstringID do contato

Exemplo de requisição

curl "https://api.socialsell.ai/v1/contacts/664f1a2b3c4d5e6f78901234" \
  -H "Authorization: Bearer sk_live_..."

Exemplo de resposta

{
  "data": {
    "id": "664f1a2b3c4d5e6f78901234",
    "name": "João Silva",
    "email": "joao@empresa.com.br",
    "phone": "+5511999999999",
    "instagram_username": "joaosilva",
    "whatsapp_jid": "5511999999999@s.whatsapp.net",
    "messenger_psid": null,
    "messenger_name": null,
    "source": "whatsapp",
    "avatar_url": null,
    "assigned_to": {
      "id": "664a1b2c3d4e5f6789012345",
      "name": "Maria Santos"
    },
    "company": {
      "id": "664b1c2d3e4f5a6789012346",
      "name": "Empresa ABC"
    },
    "tags": ["cliente", "vip"],
    "custom_fields": {},
    "funnel_stage": null,
    "notes_count": 2,
    "deals_count": 1,
    "messages_count": 47,
    "last_message_at": "2026-06-01T14:22:00.000Z",
    "deals": [
      {
        "id": "664c1d2e3f4a5b6789012347",
        "title": "Proposta Enterprise",
        "value": 15000,
        "status": "open",
        "stage": "Proposta enviada"
      }
    ],
    "created_at": "2026-01-15T10:30:00.000Z",
    "updated_at": "2026-06-01T14:22:00.000Z"
  },
  "meta": {
    "request_id": "req_01jx8kz3m4n5p6q7r8s9t0u1v"
  }
}

Campos adicionais (somente no GET por ID)

CampoTipoDescrição
messages_countintegerTotal de mensagens trocadas
dealsarrayNegócios vinculados (até 10) com id, title, value, status, stage

Erros

CódigoStatusDescrição
INVALID_ID400ID com formato inválido
NOT_FOUND404Contato não encontrado na organização