1. Listar todos os contatos da conta

Endpoint:

GET /api/contacts/

Retorna a lista completa de contatos vinculados à accountId informada.

Campos do request: 

Exemplo de request:

curl --request GET \
  --url https://api.sacflow.io/api/contacts?accountId=ACCOUNT_ID \
  --header 'authorization: Bearer API_TOKEN' \
  --header 'content-type: application/json'

Exemplo de response (paginado):

{
  "contacts": [
    { /* objeto do contato */ },
    { /* objeto do contato */ }
  ],
  "count": 1231,
  "page": 1,
  "hasMore": true
}

Descrição dos campos de paginação:

Como paginar:
Use pageNumber (página, começa em 1) e limit (itens por página, default 20), exemplo:

# Página 1
GET /contacts?pageNumber=1&limit=20

# Página 2
GET /contacts?pageNumber=2&limit=20

2. Buscar contato específico

Endpoint:

GET /api/contacts/find

Retorna os dados de um único contato, identificado pelos parâmetros fornecidos na URL

Campos do request: 

* Pelo menos um entre id, number e email é obrigatório.

Exemplo de uso:

# Busca por id:
curl --request GET \
  --url 'https://api.sacflow.io/api/contacts/find?accountId=1&id=1' \
  --header 'authorization: Bearer API_TOKEN' \
  --header 'content-type: application/json'

# Busca por número de telefone:
curl --request GET \
  --url 'https://api.sacflow.io/api/contacts/find?accountId=1&number=5511999999999' \
  --header 'authorization: Bearer API_TOKEN' \
  --header 'content-type: application/json' 

# Busca por email:
curl --request GET \
  --url 'https://api.sacflow.io/api/contacts/[email protected]' \
  --header 'authorization: Bearer API_TOKEN' \
  --header 'content-type: application/json'

Exemplo de response (200):

{
  "id": 1,
  "accountId": 1,
  "name": "Contato Exemplo",
  "number": "5511999999999",
  "email": "[email protected]",
  "company": null,
  "tags": [{ "id": 1 }],
  "organization": { "id": 1, "name": "Empresa Exemplo" }
}

Contato não encontrado (404):

{
  "message": "Contact not found"
}

Autenticação

Todas as requisições devem incluir o header authorization com um Bearer token válido:

authorization: Bearer API_TOKEN