Carteiras

Listar

get

Listagem paginada de carteiras.

Autorizações
Parâmetros de consulta
CreatedAt.Beforestring · date-timeOpcional

Limite superior de busca, sempre em fuso horário UTM.

CreatedAt.Afterstring · date-timeOpcional

Limite inferior de busca, sempre em fuso horário UTM.

UpdatedAt.Beforestring · date-timeOpcional

Limite superior de busca, sempre em fuso horário UTM.

UpdatedAt.Afterstring · date-timeOpcional

Limite inferior de busca, sempre em fuso horário UTM.

PageNumberinteger · int32 · máx: 2147483647Opcional

Número da página a ser obtida.

Default: 1
PageSizeinteger · int32 · mín: 1 · máx: 100Opcional

Tamanho da página a ser obtida.

Default: 15
OrderBystringOpcional

Nome do campo para ser utilizado como pivô da ordenação.

OrderDirectionstring · enumOpcional

Determina se a ordenação deve ser crescente ou decrescente.

Valores possíveis:
Respostas
200

Success

application/json
get
/v1/portfolio
GET /core/v1/portfolio HTTP/1.1
Host: api.wts.chat
Authorization: YOUR_API_KEY
Accept: */*

{
  "pageNumber": 1,
  "pageSize": 15,
  "orderBy": "text",
  "orderDirection": "ASCENDING",
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2025-11-06T22:36:18.351Z",
      "updatedAt": "2025-11-06T22:36:18.351Z",
      "active": true,
      "companyId": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "automaticAttribution": true,
      "expirationDurationInMonths": 1,
      "contactsCount": 1,
      "type": "MULTIPLE",
      "departments": [
        {
          "departmentId": "123e4567-e89b-12d3-a456-426614174000",
          "userIds": [
            "123e4567-e89b-12d3-a456-426614174000"
          ]
        }
      ]
    }
  ],
  "totalItems": 1,
  "totalPages": 1,
  "hasMorePages": true
}

Listar contatos

get

Listagem de contatos associados a uma carteira.

Autorizações
Parâmetros de rota
idstring · uuidObrigatório

Id da carteira.

Parâmetros de consulta
CreatedAt.Beforestring · date-timeOpcional
CreatedAt.Afterstring · date-timeOpcional
CreatedAt.ApplyCompanyTimezonebooleanOpcional
CreatedAt.IsNullbooleanOpcional
UpdatedAt.Beforestring · date-timeOpcional
UpdatedAt.Afterstring · date-timeOpcional
UpdatedAt.ApplyCompanyTimezonebooleanOpcional
UpdatedAt.IsNullbooleanOpcional
ContactIdsstring · uuid[]Opcional
Pageinteger · int32Opcional
PageSizeinteger · int32Opcional
OrderBystringOpcional
OrderByDescstringOpcional
TimestampFieldstringOpcional
TimestampFilterstring · date-timeOpcional
NextPageTokenstringOpcional
Typestring · enumOpcionalValores possíveis:
Respostas
200

Success

application/json
get
/v1/portfolio/{id}/contact
GET /core/v1/portfolio/{id}/contact HTTP/1.1
Host: api.wts.chat
Authorization: YOUR_API_KEY
Accept: */*

{
  "pageNumber": 1,
  "pageSize": 15,
  "orderBy": "text",
  "orderDirection": "ASCENDING",
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2025-11-06T22:36:18.351Z",
      "updatedAt": "2025-11-06T22:36:18.351Z",
      "active": true,
      "companyId": "123e4567-e89b-12d3-a456-426614174000",
      "portfolioId": "123e4567-e89b-12d3-a456-426614174000",
      "contactId": "123e4567-e89b-12d3-a456-426614174000",
      "contactDetails": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "phonenumber": "text",
        "phonenumberFormatted": "text",
        "instagram": "text",
        "nameMessenger": "text",
        "email": "text",
        "annotation": "text"
      }
    }
  ],
  "totalItems": 1,
  "totalPages": 1,
  "hasMorePages": true
}

Adicionar contato

post

Adicione um contato em uma carteira.

Autorizações
Parâmetros de rota
idstring · uuidObrigatório

Id da carteira.

Corpo
contactIdstring · uuid | nuloOpcional
phoneNumberstring | nuloOpcional
Respostas
200

Success

application/json
post
/v1/portfolio/{id}/contact
POST /core/v1/portfolio/{id}/contact HTTP/1.1
Host: api.wts.chat
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 73

{
  "contactId": "123e4567-e89b-12d3-a456-426614174000",
  "phoneNumber": "text"
}
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-11-06T22:36:18.351Z",
  "updatedAt": "2025-11-06T22:36:18.351Z",
  "active": true,
  "companyId": "123e4567-e89b-12d3-a456-426614174000",
  "portfolioId": "123e4567-e89b-12d3-a456-426614174000",
  "contactId": "123e4567-e89b-12d3-a456-426614174000",
  "contactDetails": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "phonenumber": "text",
    "phonenumberFormatted": "text",
    "instagram": "text",
    "nameMessenger": "text",
    "email": "text",
    "annotation": "text"
  }
}

Remover contato

delete

Remova um contato de uma carteira.

Autorizações
Parâmetros de rota
idstring · uuidObrigatório

Id da carteira.

Corpo
contactIdstring · uuid | nuloOpcional
phoneNumberstring | nuloOpcional
Respostas
200

Success

Sem conteúdo
delete
/v1/portfolio/{id}/contact
DELETE /core/v1/portfolio/{id}/contact HTTP/1.1
Host: api.wts.chat
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 73

{
  "contactId": "123e4567-e89b-12d3-a456-426614174000",
  "phoneNumber": "text"
}
Sem conteúdo

Adicionar contatos

post

Adicione contatos em uma carteira adicionando um filtro.

Autorizações
Parâmetros de rota
idstring · uuidObrigatório

Id da carteira.

Corpo
contactIdsstring · uuid[] | nuloOpcional
phoneNumbersstring[] | nuloOpcional
Respostas
200

Success

application/json
post
/v1/portfolio/{id}/contact/batch
POST /core/v1/portfolio/{id}/contact/batch HTTP/1.1
Host: api.wts.chat
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 79

{
  "contactIds": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "phoneNumbers": [
    "text"
  ]
}
{
  "pageNumber": 1,
  "pageSize": 15,
  "orderBy": "text",
  "orderDirection": "ASCENDING",
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2025-11-06T22:36:18.351Z",
      "updatedAt": "2025-11-06T22:36:18.351Z",
      "active": true,
      "companyId": "123e4567-e89b-12d3-a456-426614174000",
      "portfolioId": "123e4567-e89b-12d3-a456-426614174000",
      "contactId": "123e4567-e89b-12d3-a456-426614174000",
      "contactDetails": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "phonenumber": "text",
        "phonenumberFormatted": "text",
        "instagram": "text",
        "nameMessenger": "text",
        "email": "text",
        "annotation": "text"
      }
    }
  ],
  "totalItems": 1,
  "totalPages": 1,
  "hasMorePages": true
}

Remover contatos

delete

Remova contatos de uma carteira adicionando um filtro.

Autorizações
Parâmetros de rota
idstring · uuidObrigatório

Id da carteira.

Corpo
contactIdsstring · uuid[] | nuloOpcional
phoneNumbersstring[] | nuloOpcional
Respostas
200

Success

Sem conteúdo
delete
/v1/portfolio/{id}/contact/batch
DELETE /core/v1/portfolio/{id}/contact/batch HTTP/1.1
Host: api.wts.chat
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 79

{
  "contactIds": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "phoneNumbers": [
    "text"
  ]
}
Sem conteúdo

Atualizado