# Informações Gerais

1. Há muitas formas de trabalhar com a Chat2Desk. Todas elas são descritas no TherearemanywaystoworkwithChat2Desk.Allof them are described in [Guia inicial do desenvolvedor](https://176009.selcdn.ru/storage/docs/Developers%20starting%20guide.pdf)
2. Use esse link para acessar uma coleção de comandos predefinidos da API para Chat2Desk no app Postman:

[**https://documenter.getpostman.com/view/9553101/SW7gSQAM**](https://documenter.getpostman.com/view/9553101/SW7gSQAM)

Você deve inserir seu token API para usar esses comandos (veja o item 6 abaixo) ou usar esses commandos (veja o item 6 abaixo).

3\. Arquitetura RESTful é métodos GET, PUT, DELETE e POST são usados.

4\. Resultados dos comandos são apresentados no format JSON.

5\. Esta aPI usa protocol HTTPS.

6\. Autorização baseada em token,que está disponível em Configurações/API no site Chat2Desk (como admin). Aqui estão os parâmetros pra todos os comandos:

**Authorization: \<token>**\
**Host: <https://api.chat24.io>**

7\. Comandos que retornam uma lista grande de dados aceitam paginação usando parâmetros URL:

a. limit–número de registros retornados (máximo é 200, padrão é 20)&#x20;

b. offset –compensação do primeiro registro da lista (o padrão é 0). Exemplo de request (lista de clientes): /v1/clients?offset=50\&limit=30

8\. Em geral, o sistema é projetado para responder aos clientes que contataram primeiro sua Empresa e estão na lista de seus clientes. Mas usando clients (POST) você pode criar um novo cliente e então contatá-lo sem que ele envie mensagem primeiro.

9\. Se o erro ocorre quando o pedido é executado, resposta detalhada com tipo de descrição do erro será dada.

Parâmetros:

• message – tipo de erro;&#x20;

o 400-bad\_request;&#x20;

o 401- não autorizado;&#x20;

o 403 – proibido;&#x20;

o 404- não encontrado;&#x20;

o 500 – erro improcessavel.&#x20;

• errors – descrição detalhada

Exemplos:

![](https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FFUD9cRx6ubtSi9Deh4UK%2Fimage.png?alt=media\&token=e32b4ad5-0d3c-4086-8a78-56cae46987ed)

![](https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FXBhWjJ5rouQwRDVgTuKw%2Fimage.png?alt=media\&token=56038532-f4b7-4cad-ad50-4620b7aac864)