ZDK (Kit de Desenvolvimento Zappy)

ZDK é um SDK poderoso projetado para simplificar interações com a API da Zappy, permitindo gerenciar conexões, contatos, mensagens, filas, tags, tickets e usuários.

Instalação

Instale o ZDK via npm:

npm install zdk

Ou usando Yarn:

yarn add zdk

Configuração

Para inicializar o Zdk, você pode fornecer rootUrl e token como argumentos ou configurá-los como variáveis de ambiente. Ambos rootUrl e token são argumentos opcionais se as variáveis de ambiente ZAPPY_URL e ZAPPY_TOKEN estiverem configuradas.

Usando argumentos

const { Zdk } = require('zdk');

const zdk = new Zdk("https://api-example.chat", "TOKEN");

Usando variáveis de ambiente

Alternativamente, você pode configurar as variáveis de ambiente para evitar passar rootUrl e token diretamente no seu código:

export ZAPPY_URL="https://api-example.chat"
export ZAPPY_TOKEN="TOKEN"

Com as variáveis de ambiente configuradas, você pode inicializar a classe Zdk sem argumentos:

const { Zdk } = require('zdk');

const zdk = new Zdk();

Visão Geral

ZappyApi

A classe ZappyApi é a classe base para realizar solicitações de API de baixo nível. Ela inclui o método makeRequest para solicitações HTTP gerais.

makeRequest(método, endpoint, corpo?, tipoDeConteúdo?): Envia uma solicitação para o endpoint especificado com corpo e tipoDeConteúdo opcionais. Parâmetros: método: Método HTTP (GET, POST, etc.). endpoint: Endpoint da API (string). corpo (opcional): Payload da solicitação. tipoDeConteúdo (opcional): Tipo MIME, por exemplo, application/json.

Zdk

A classe Zdk estende ZapApi e inclui propriedades para gerenciar recursos principais da API Zappy. Cada propriedade é uma instância de uma classe especializada que fornece métodos específicos para manipulação de dados e operações.

Propriedades

| Propriedade | Descrição | | ----------- | ------------------------------------------------------ | | connections | Gerencia conexões da instância | | contacts | Gerencia contatos, como buscar e criar novos contatos. | | messages | Gerencia operações relacionadas a mensagens. | | queues | Gerencia filas para organização de atendimento. | | tags | Gerencia funcionalidade de tags para categorização. | | tickets | Gerencia tickets de atendimento. | | users | Acessa métodos relacionados a usuários do sistema. |

Documentação completa