Pastorini API

API completa para WhatsApp com suporte a mensagens interativas
Botões, Listas, Carrossel, Mídia e muito mais

---

📋 Recursos

• ✅ Envio de mensagens de texto, imagem, vídeo, áudio, documento
• ✅ Botões interativos (Reply, URL, Call, Copy)
• ✅ Listas/Menus com seções e opções
• ✅ Carrossel de cards com imagens e botões
• ✅ Gerenciamento de grupos
• ✅ Webhooks configuráveis por instância
• ✅ Múltiplas instâncias simultâneas
• ✅ Painel web integrado
• ✅ API Tester embutido
• ✅ Suporte a PostgreSQL + Redis para alta escala

---

🚀 Instalação

Pré-requisitos

• Node.js 18+
• Docker e Docker Compose ou swarm (recomendado)
• Chave de licença válida

# Clone o repositório
git clone https://github.com/mktpastorini/papi.git
cd pastorini-api

# Configure as variáveis de ambiente
cp .env.example .env
# Edite o .env com sua LICENSE_KEY

# Inicie com Docker Compose
docker-compose up -d

Via NPM

# Instale as dependências
npm install

# Configure as variáveis de ambiente
cp .env.example .env

# Inicie o servidor
npm run server

---

⚙️ Configuração

Edite o arquivo .env:

# =================================================================
# STORAGE CONFIGURATION
# =================================================================
# Opções: file | postgres | postgres+redis
# - file: Armazena no disco (padrão, bom para desenvolvimento)
# - postgres: Armazena no PostgreSQL (melhor para produção)
# - postgres+redis: PostgreSQL + Redis cache (máxima performance)

STORAGE_TYPE=postgres+redis

# Senha do seu painel, se deixar em branco ele abrira sem senha
PANEL_API_KEY=SUA_senha_do_PAINEL

# =================================================================
# POSTGRESQL (usado quando STORAGE_TYPE = postgres ou postgres+redis)
# =================================================================
POSTGRES_HOST=127.0.0.1
POSTGRES_PORT=5433
POSTGRES_DB=pastorini_api
POSTGRES_USER=pastorini
POSTGRES_PASSWORD=pastorini123
POSTGRES_SSL=false

# =================================================================
# REDIS (usado quando STORAGE_TYPE = postgres+redis)
# =================================================================
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=
REDIS_DB=0

# =================================================================
# SERVER
# =================================================================
PORT=3000

# =================================================================
# Chave de licença fornecida no cadastro entre em contato no grupo após subir a instalação
LICENSE_KEY=Sua_chave_do_cadastro_aqui

# URL do servidor admin de licenças
LICENSE_ADMIN_URL=https://padmin.intrategica.com.br/

# =================================================================
# WHATSAPP (opcional)
# =================================================================
# Versão do WhatsApp (deixe comentado para usar a mais recente)
# CONFIG_SESSION_PHONE_VERSION=2.24.6.77

---

📖 Documentação

Após iniciar o servidor, acesse:

Recurso	URL
Painel Principal	http://localhost:3000
Documentação da API	http://localhost:3000/docs.html
API Tester	http://localhost:3000/api-tester.html

---

🔗 Endpoints Principais

Instâncias

Método	Endpoint	Descrição
GET	/api/instances	Listar instâncias
POST	/api/instances	Criar instância
GET	/api/instances/:id/qr	Obter QR Code
GET	/api/instances/:id/status	Status da instância
DELETE	/api/instances/:id	Deletar instância

Mensagens

Método	Endpoint	Descrição
POST	/api/instances/:id/send-text	Enviar texto
POST	/api/instances/:id/send-image	Enviar imagem
POST	/api/instances/:id/send-buttons	Enviar botões
POST	/api/instances/:id/send-list	Enviar lista/menu
POST	/api/instances/:id/send-carousel	Enviar carrossel

Webhooks

Método	Endpoint	Descrição
GET	/api/instances/:id/webhook	Obter config webhook
POST	/api/instances/:id/webhook	Configurar webhook

---

📱 Exemplo de Uso

Enviar Mensagem com Botões

curl -X POST http://localhost:3000/api/instances/default/send-buttons \
  -H "Content-Type: application/json" \
  -d '{
    "jid": "[email protected]",
    "text": "Escolha uma opção:",
    "footer": "Pastorini API",
    "buttons": [
      { "type": "reply", "displayText": "Opção 1", "id": "btn1" },
      { "type": "url", "displayText": "Site", "url": "https://google.com" }
    ]
  }'

Enviar Carrossel

curl -X POST http://localhost:3000/api/instances/default/send-carousel \
  -H "Content-Type: application/json" \
  -d '{
    "jid": "[email protected]",
    "cards": [
      {
        "header": { "title": "Produto 1", "imageUrl": "https://exemplo.com/img.jpg" },
        "body": "Descrição do produto",
        "footer": "R$ 99,90",
        "buttons": [
          { "displayText": "Comprar", "urlButton": { "url": "https://loja.com" } }
        ]
      }
    ]
  }'

---

https://chat.whatsapp.com/BL1yLEFDjmkFB1yLkQVsCn

📞 Suporte

• Criador: Matheus Pastorini
• WhatsApp: +55 82 98889-8565
• Documentação: Acesse /docs.html no painel
• Grupos Oficial Automatik: [Acessar Grupo Oficial (https://chat.whatsapp.com/BL1yLEFDjmkFB1yLkQVsCn)
• Ajude a manter o projeto: pix: 82988898565

---

⚠️ Aviso Legal

Este software requer uma licença válida para funcionamento. O uso não autorizado é proibido.

---

© 2025 Pastorini API
Powered by Baileys