n8n-nodes-digitalsac 0.5.0 → 0.5.1

package/README.md

@@ -50,7 +50,7 @@ cd ~/.n8n
 npm install n8n-nodes-digitalsac
 ```
 
-## ✨ Novas Funcionalidades (v0.5.0)
+## ✨ Novas Funcionalidades (v0.5.1)
 
 ### 🔘 Enviar Botões Interativos
 Envie mensagens com botões clicáveis:
@@ -165,6 +165,151 @@ Onde:
 - **Sem arquivo**: Envia como JSON (texto)
 - **Com arquivo**: Envia como FormData (arquivo + texto)
 
+### 🔘 Enviar Botões Interativos
+1. Selecione a operação **Enviar Botões**
+2. No campo **Parâmetro**, insira o UUID da conexão
+3. Preencha os campos básicos:
+   - **Título**: "Escolha uma opção"
+   - **Corpo da Mensagem**: "Clique em uma das opções abaixo:"
+   - **Número de Telefone**: "5511999999999"
+   - **Chave Externa**: "btn_001"
+4. No campo **Botões (JSON)**, configure os botões:
+
+```json
+[
+  {
+    "tipo": {"label": "Resposta Rápida", "value": "quick_reply"},
+    "display_text": "✅ Sim",
+    "conteudo": "sim"
+  },
+  {
+    "tipo": {"label": "Resposta Rápida", "value": "quick_reply"},
+    "display_text": "❌ Não",
+    "conteudo": "nao"
+  },
+  {
+    "tipo": {"label": "URL", "value": "url"},
+    "display_text": "🌐 Visitar Site",
+    "conteudo": "https://www.digitalsac.com.br"
+  },
+  {
+    "tipo": {"label": "Copiar", "value": "copy"},
+    "display_text": "📋 Copiar Código",
+    "conteudo": "PROMO2024"
+  },
+  {
+    "tipo": {"label": "Ligar", "value": "call"},
+    "display_text": "📞 Ligar Agora",
+    "conteudo": "5511999999999"
+  }
+]
+```
+
+**Tipos de botão disponíveis:**
+- `quick_reply`: Resposta rápida (o texto vai para o chat)
+- `url`: Abre um link no navegador
+- `copy`: Copia texto para área de transferência
+- `call`: Inicia uma chamada telefônica
+
+### 📋 Enviar Lista
+1. Selecione a operação **Enviar Lista**
+2. No campo **Parâmetro**, insira o UUID da conexão
+3. Preencha os campos básicos:
+   - **Título**: "Menu de Opções"
+   - **Texto**: "Escolha uma categoria:"
+   - **Texto do Botão**: "Ver Opções"
+   - **Rodapé**: "Powered by DigitalSac"
+   - **Número de Telefone**: "5511999999999"
+   - **Chave Externa**: "list_001"
+4. No campo **Seções (JSON)**, configure as seções:
+
+```json
+[
+  {
+    "title": "🛍️ Produtos",
+    "lines": [
+      {
+        "title": "Smartphone Premium",
+        "description": "iPhone 15 Pro Max 256GB",
+        "rowId": "prod_iphone"
+      },
+      {
+        "title": "Notebook Gamer",
+        "description": "Dell Alienware com RTX 4090",
+        "rowId": "prod_notebook"
+      }
+    ]
+  },
+  {
+    "title": "🛠️ Serviços",
+    "lines": [
+      {
+        "title": "Suporte Técnico",
+        "description": "Assistência técnica especializada",
+        "rowId": "serv_suporte"
+      },
+      {
+        "title": "Consultoria",
+        "description": "Consultoria personalizada",
+        "rowId": "serv_consultoria"
+      }
+    ]
+  },
+  {
+    "title": "📞 Contato",
+    "lines": [
+      {
+        "title": "Falar com Vendedor",
+        "description": "Atendimento comercial",
+        "rowId": "cont_vendas"
+      }
+    ]
+  }
+]
+```
+
+### 🖼️ Enviar Mídia com Caption
+1. **Conecte um nó com arquivo** (ex: HTTP Request, Read Binary File, Google Drive)
+2. Conecte ao nó **Digitalsac**
+3. Selecione a operação **Enviar Mídia com Caption**
+4. No campo **Parâmetro**, insira o UUID da conexão
+5. Preencha os campos:
+   - **Caption**: "Esta é uma imagem importante do produto"
+   - **Número de Telefone**: "5511999999999"
+   - **Chave Externa**: "media_001"
+
+**Tipos de arquivo suportados:**
+- 🖼️ Imagens: JPG, PNG, GIF
+- 📄 Documentos: PDF, DOC, DOCX
+- 🎥 Vídeos: MP4, AVI
+- 🎵 Áudio: MP3, WAV
+
+### 📁 Enviar Base64
+1. Selecione a operação **Enviar Base64**
+2. No campo **Parâmetro**, insira o UUID da conexão
+3. Preencha os campos:
+   - **Caption (Opcional)**: "Documento enviado via API"
+   - **Número de Telefone**: "5511999999999"
+   - **Arquivo Base64**: Cole o arquivo codificado em base64
+   - **Tipo MIME**: "application/pdf" (ou conforme o arquivo)
+   - **Nome do Arquivo**: "documento.pdf"
+   - **Chave Externa**: "base64_001"
+
+**Exemplo de uso com código base64:**
+```json
+{
+  "caption": "Relatório mensal de vendas",
+  "mediaBase64": "JVBERi0xLjQKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQo+PgplbmRvYmoKeHJlZgowIDQKMDAwMDAwMDAwMCA2NTUzNSBmCjAwMDAwMDAwMDkgMDAwMDAgbgowMDAwMDAwMDc0IDAwMDAwIG4KMDAwMDAwMDEyMCAwMDAwMCBuCnRyYWlsZXIKPDwKL1NpemUgNAovUm9vdCAxIDAgUgo+PgpzdGFydHhyZWYKMTc5CiUlRU9G",
+  "mimeType": "application/pdf",
+  "fileName": "relatorio.pdf"
+}
+```
+
+**Dica**: Para converter arquivo para base64:
+- **Linux/Mac**: `base64 arquivo.pdf`
+- **Windows**: Use PowerShell: `[Convert]::ToBase64String([IO.File]::ReadAllBytes("arquivo.pdf"))`
+- **Online**: Use conversores como base64encode.org
+
 ### Listar Tags
 1. Selecione a operação **Listar Tags**
 2. Não é necessário configurar parâmetros adicionais
@@ -488,6 +633,74 @@ Gera um link para download do arquivo .ics (calendário) de um agendamento espec
 - Pode ser importado em qualquer aplicativo de calendário (Google Calendar, Outlook, Apple Calendar, etc.)
 - É útil para integração com sistemas externos ou envio para clientes
 
+## 💡 Casos de Uso Práticos
+
+### 🤖 Bot de Atendimento Interativo
+Combine as novas operações para criar um fluxo completo:
+
+1. **Enviar Botões** → Menu inicial com opções
+2. **Enviar Lista** → Catálogo de produtos/serviços  
+3. **Enviar Mídia** → Imagens dos produtos
+4. **Enviar Base64** → Contratos/documentos
+
+### 🛒 E-commerce Automation
+```
+Trigger (Webhook) 
+    ↓
+Enviar Botões (Confirmar pedido?)
+    ↓
+Enviar Lista (Formas de pagamento)
+    ↓
+Enviar Base64 (Contrato PDF)
+    ↓
+Enviar Mídia (Comprovante)
+```
+
+### 📊 Relatórios Automatizados
+```
+Scheduler (Diário)
+    ↓
+HTTP Request (Buscar dados)
+    ↓
+Code (Gerar gráfico base64)
+    ↓
+Enviar Base64 (Relatório visual)
+```
+
+### 🎯 Marketing Campaigns
+```
+Database (Lista clientes)
+    ↓
+Loop (Para cada cliente)
+    ↓
+Enviar Botões (CTA personalizado)
+    ↓
+Webhook (Capturar resposta)
+```
+
+### 🔄 Workflow Exemplo Completo
+**Cenário**: Venda de produto com confirmação interativa
+
+```
+1. Webhook (Novo lead)
+    ↓
+2. Enviar Botões ("Interesse em comprar?")
+    ↓
+3. IF (Resposta = "Sim")
+    ↓
+4. Enviar Lista (Catálogo produtos)
+    ↓
+5. HTTP Request (Buscar detalhes do produto)
+    ↓
+6. Enviar Mídia (Foto do produto)
+    ↓
+7. Enviar Botões ("Fechar pedido?")
+    ↓
+8. Enviar Base64 (Contrato PDF)
+    ↓
+9. Webhook (Notificar vendedor)
+```
+
 ## Suporte
 
 Para suporte, entre em contato com [contato@digitalsac.io](mailto:contato@digitalsac.io).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-digitalsac",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Izing Pro Digitalsac",
   "keywords": [
     "n8n",