Introdução

GZAPPY-JS é um pacote JavaScript que facilita a integração com a API de WhatsApp da GZAPPY.

Conteúdo

Acesse o blog gzappy e acompanhe conteúdos sobre programação e desenvolvimento de software.

👉 Blog GZAPPY

Funcionalidades

• Envio de mensagens ✅
• Envio de mídias ✅
• Envio de mensagens para grupos ✅
• Agendamento de mensagens ✅
• Criar instância ✅
• Listar instâncias ✅
• Editar instância ✅
• Desconectar instância ✅
• Reconectar instância ✅
• Novo lead ⏱️
• Listar leads ⏱️
• Editar lead ⏱️
• Excluir lead ⏱️
• Listar grupos ⏱️
• Editar grupo ⏱️
• Excluir grupo ⏱️
• Criar Tag ⏱️
• Listar Tags ⏱️
• Editar Tag ⏱️
• Excluir Tag ⏱️

Autenticação

A partir da versão 0.0.16, a autenticação é feita através do cabeçalho Authorization com o API Token gerado no painel da GZAPPY.

Documentação

Você pode encontrar a documentação completa em https://docs.gzappy.com.

Instalação

Para instalar o GZAPPY, execute o seguinte comando:

npm install gzappy-js

Para começar a usar o GZAPPY, você precisa importar o módulo e criar uma instância do cliente.

É necessário ter um token de acesso e o ID da instância. Você pode obter essas informações no painel da GZAPPY.

IMPORTANTE: O token e o ID da instância deve ser mantido em segredo. utilize variáveis de ambiente para armazenar essas informações.

Exemplo ECMAScript

// Importação do módulo gzappy-js
import gzappy from 'gzappy-js'

// Definição das variáveis de ambiente
const token = process.env.GZAPPY_API_TOKEN
const instanceId = process.env.GZAPPY_INSTANCE_ID

// Criação de uma instância do gzappy client
const gClient = new gzappy({ token, instanceId })

Exemplo CommonJS

// Importação do módulo gzappy-js
const gzappy = require('gzappy-js').default

// Definição das variáveis de ambiente
const token = process.env.GZAPPY_API_TOKEN
const instanceId = process.env.GZAPPY_INSTANCE_ID

// Criação de uma instância do gzappy client
const gClient = new gzappy({ token, instanceId })

Uso

Este é um exemplo simples de como configurar e usar esta biblioteca. Você pode ler mais em https://docs.gzappy.com.

INSTANCIAS

Listar instâncias

// Listando instancias
gClient
  .listInstances()
  .then((response) => console.log(response))
  .catch((error) => console.error(error))

Criar instância

// Listando instancias
gClient
  .createInstance('Minha primeira instância')
  .then((response) => console.log(response))
  .catch((error) => console.error(error))

Restaurar instância

const INSTANCE_ID = 'ID DA INSTANCIA'

// Listando instancias
gClient
  .restoreInstance(INSTANCE_ID)
  .then((response) => console.log(response))
  .catch((error) => console.error(error))

Deletar instância

const INSTANCE_ID = 'ID DA INSTANCIA'

// Listando instancias
gClient
  .deleteInstance(INSTANCE_ID)
  .then((response) => console.log(response))
  .catch((error) => console.error(error))

Desconectar instância

const INSTANCE_ID = 'ID DA INSTANCIA'

// Listando instancias
gClient
  .disconnectInstance(INSTANCE_ID)
  .then((response) => console.log(response))
  .catch((error) => console.error(error))

Editar instância

const INSTANCE_ID = 'ID DA INSTANCIA'
const WEBHOOK_URL = 'https://example.com/webhook'

// Listando instancias
gClient
  .editInstance(INSTANCE_ID, 'Novo nome da instância', WEBHOOK_URL)
  .then((response) => console.log(response))
  .catch((error) => console.error(error))

MENSAGENS

Envio mensagens

// Enviando mensagens
const messages = ['Você tem um novo agendamento marcado, Sr Cliente']
const phones = ['5511999999999']

gClient
  .sendMessage(messages, phones)
  .then((response) => console.log(response))
  .catch((error) => console.error(error))

Envio de mídias

const message = 'Confira o anexo!'
const mediaUrl = 'https://example.com/path/to/media.jpg'

gClient
  .sendMedia(message, mediaUrl, phones)
  .then((response) => console.log(response))
  .catch((error) => console.error(error))

Envio de Mensagens para Grupos

const groups = ['group1_id', 'group2_id']

gClient
  .sendGroupMessage(messages, groups)
  .then((response) => console.log(response))
  .catch((error) => console.error(error))

Agendamento de Mensagens

const scheduleUtcDate = 'YYYY-MM-DDTHH:mm:ss+00'

gClient
  .scheduleMessage(messages, phones, scheduleUtcDate)
  .then((response) => console.log(response))
  .catch((error) => console.error(error))