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.

Requisição

Parâmetros de Consulta

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200OK

application/json

Lista com informações dos contatos filtrados.

Body

🔴500Erro do Servidor

🟠400Solicitação Incorreta

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://seupabxutech.exemplo.com.br/utech/v1/contacts/contactget?token&page' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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"
                    }
                }
            }
        },
        "total": 1,
        "count": 0,
        "page": 0
    }
}

Modificado em 2025-09-09 12:47:04