Buscar contatos

POST

/utech/v1/contacts/contactget

Endpoint utilizado para buscar/flltrar contatos do PABX. Tamanho máximo da lista será de 200 contatos. Deve-se utilizar parâmetro page, para buscar os próximos 200. Os valores aceitos para o parâmetro page são de 0 a 5000. A pesquisa pode ser realizada por ID do contato ou número.

Versão do PABX

Igual ou superior a versão 2.0.1 - Qua 03 Set 2025 15:01:31 -03 C7

Parametro tags inserido na versão superior a 2.0.1 - Qui 30 Jul 2026 15:01:31 -03 A9

Parâmetro last_update inserido na versão superior a 2.0.1 - Qui 30 Jul 2026 15:01:31 -03 A9

Parâmetro groups inserido na versão superior a 3.0.1 - Qui 06 Ago 2026 11:36:15 -03 A9

Requisição

Parâmetros de Consulta

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200OK

application/json

Lista com informações dos contatos filtrados.

Bodyapplication/json

🔴500Erro do Servidor

🟠400Solicitação Incorreta

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://seupabxutech.exemplo.com.br/utech/v1/contacts/contactget?token=d743a66706879a1b700d44f2aba90070&page=0&tags=true&groups=true' \
--header 'Content-Type: application/json' \
--data '{
    "number": "33334840"
}'

Response Example

200 - Lista de contatos

{
    "status": "ok",
    "data": {
        "contacts": {
            "61": {
                "name": "John Doe",
                "birthday": "1970-01-01",
                "email": "john.doe@email.com.br",
                "type": "2",
                "company": "uTech Tecnologia",
                "area": "Documentacao",
                "title": "Engenheiro",
                "cpf": "111.111.111-11",
                "cnpj": "12.121.212/1212-12",
                "rg": "123.123.123",
                "document": "1.2.3.4",
                "code": "4321",
                "address": "Rua Idalina Pereira dos Santos, 67 - Sala 702",
                "postalcode": "88025-260",
                "observations": "Teste",
                "attendant": "1000",
                "numbers": {
                    "mobile": {
                        "priority": "0",
                        "number": "48988887777"
                    },
                    "home": {
                        "priority": "1",
                        "number": "4833334840"
                    },
                    "business": {
                        "priority": "2",
                        "number": "4833334840"
                    },
                    "extension": {
                        "number": "1001"
                    },
                    "whatsapp": {
                        "priority": "3",
                        "number": "48999998888"
                    },
                    "facebook": {
                        "number": "1234567890"
                    },
                    "telegram": {
                        "number": "utechnet_bot"
                    },
                    "twitter": {
                        "number": "utechnet"
                    },
                    "instagram": {
                        "number": "utechoficial"
                    }
                },
                "tags": {
                    "1": {
                        "name": "Cliente Final",
                        "description": "",
                        "color": "#8fce00"
                    },
                    "2": {
                        "name": "Revenda",
                        "description": "",
                        "color": "#f1c232"
                    },
                    "4": {
                        "name": "Integrador",
                        "description": "",
                        "color": "#38761d"
                    }
                },
                "groups": {
                    "1": {
                        "id": "2",
                        "name": "Mailing 1",
                        "description": "Mailing teste 1",
                        "created": "2026-09-15 17:02:40",
                        "modified": "2026-09-15 17:02:40"
                    },
                    "2": {
                        "id": "2",
                        "name": "Mailing 1",
                        "description": "Mailing teste 2",
                        "created": "2026-09-15 17:03:18",
                        "modified": "2026-09-15 17:03:18"
                    }
                }
            }
        },
        "total": 1,
        "count": 0,
        "page": 0
    }
}

Modificado em 2026-09-17 17:31:16