n8n-nodes-pastorini-api

Nó customizado do n8n para integração completa com a Pastorini API - a API de WhatsApp mais completa do mercado.

🚀 Funcionalidades

Instâncias

• ✅ Criar, listar e gerenciar instâncias
• ✅ Obter QR Code para conexão
• ✅ Verificar status da conexão
• ✅ Logout e exclusão de instâncias
• ✅ Verificar se número existe no WhatsApp

Mensagens

• ✅ Enviar texto, imagem, vídeo, áudio
• ✅ Enviar documentos, localização, contatos
• ✅ Enviar stickers e reações
• ✅ Deletar e editar mensagens

Mensagens Interativas

• ✅ Botões (quick_reply, cta_url, cta_call, cta_copy)
• ✅ Listas com múltiplas seções
• ✅ Enquetes/Polls
• ✅ Carrosséis de cards com imagens

Webhook & Configurações

• ✅ Configurar webhook para receber eventos
• ✅ Configurações automáticas (rejeitar chamadas, sempre online, etc)
• ✅ Gerenciar privacidade e perfil

📦 Instalação

Instalação via npm (quando publicado)

npm install n8n-nodes-pastorini-api

Instalação manual

1. Clone este repositório
2. Navegue até o diretório
3. Execute:

npm install
npm run build
npm link

4. Na pasta do seu n8n, execute:

npm link n8n-nodes-pastorini-api

5. Reinicie o n8n

🔧 Configuração

1. Adicione as Credenciais

No n8n, vá em Credentials > New > Pastorini API

Configure:

• API URL: URL base da sua instância Pastorini API (ex: https://api.seuservidor.com)
• API Key: Chave de API (x-api-key), se o servidor tiver proteção habilitada

2. Use o Nó

Adicione o nó Pastorini API no seu workflow e escolha:

• Resource: Tipo de recurso (Instance, Message, Interactive, etc)
• Operation: Operação desejada
• Instance ID: ID da sua instância

📖 Exemplos de Uso

Criar Instância e Enviar Mensagem

1. [Pastorini API] → Resource: Instance, Operation: Create
   - Instance ID: my-instance

2. [Pastorini API] → Resource: Message, Operation: Send Text
   - Instance ID: my-instance
   - JID: [email protected]
   - Text: Olá! Esta é uma mensagem de teste.

Enviar Mensagem com Botões

[Pastorini API] → Resource: Interactive, Operation: Send Buttons
- Instance ID: my-instance
- JID: [email protected]
- Text: Escolha uma opção:
- Buttons (JSON):
[
  {"type": "quick_reply", "displayText": "Sim", "id": "btn_yes"},
  {"type": "quick_reply", "displayText": "Não", "id": "btn_no"}
]

Configurar Webhook

[Pastorini API] → Resource: Webhook, Operation: Set Webhook
- Instance ID: my-instance
- Webhook URL: https://seu-n8n.com/webhook/pastorini
- Enabled: true

🎯 Recursos Disponíveis

| Recurso | Operações | |---------|-----------| | Instance | Create, List, Get Status, Get QR, Delete, Logout, Check Number | | Message | Send Text, Image, Video, Audio, Document, Location, Contact, Sticker, Reaction, Delete, Edit | | Interactive | Send Buttons, Send List, Send Poll, Send Carousel | | Webhook | Set Webhook, Get Webhook | | Settings | Set Settings, Get Settings |

🛠️ Desenvolvimento

# Instalar dependências
npm install

# Compilar em modo watch
npm run dev

# Build de produção
npm run build

# Formatar código
npm run format

# Lint
npm run lint

📄 Licença

MIT

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues e pull requests.

📞 Suporte

• Documentação da Pastorini API: https://pastorini-api.com/docs
• Issues: https://github.com/seu-usuario/n8n-nodes-pastorini-api/issues

Desenvolvido com ❤️ para a comunidade n8n