n8n-nodes-digitalsac 0.5.4 → 0.5.6

package/README.md

@@ -31,6 +31,9 @@ Este pacote adiciona um nó personalizado ao n8n para interagir com a API do Dig
   - Criar Agendamento
   - Cancelar Agendamento
   - Gerar Link do Calendário (.ics)
+- **Templates WABA:**
+  - Listar Templates WABA
+  - Enviar Template WABA
 
 ## Instalação
 
@@ -50,7 +53,21 @@ cd ~/.n8n
 npm install n8n-nodes-digitalsac
 ```
 
-## ✨ Novas Funcionalidades (v0.5.1)
+## ✨ Novas Funcionalidades (v0.5.6)
+
+### 📱 Templates WABA
+Envie templates pré-aprovados do WhatsApp Business API:
+- **Listar Templates WABA**: Busca todos os templates disponíveis na conta WABA
+- **Enviar Template WABA**: Envia template com variáveis dinâmicas para contatos
+
+**Benefícios:**
+- ✅ Templates aprovados pelo Meta/Facebook
+- ✅ Baixo custo de envio
+- ✅ Alta taxa de entrega
+- ✅ Suporte a variáveis personalizadas
+- ✅ Ideais para notificações transacionais
+
+## ✨ Funcionalidades Anteriores (v0.5.1)
 
 ### 🔘 Enviar Botões Interativos
 Envie mensagens com botões clicáveis:
@@ -211,7 +228,6 @@ Onde:
 - `copy`: Copia texto para área de transferência
 - `call`: Inicia uma chamada telefônica
 
-<!-- TEMPORARIAMENTE DESABILITADO - ENVIAR LISTA
 ### 📋 Enviar Lista
 1. Selecione a operação **Enviar Lista**
 2. No campo **Parâmetro**, insira o UUID da conexão
@@ -268,7 +284,6 @@ Onde:
   }
 ]
 ```
--->
 
 ### 🖼️ Enviar Mídia com Caption
 1. **Conecte um nó com arquivo** (ex: HTTP Request, Read Binary File, Google Drive)
@@ -635,6 +650,79 @@ 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
 
+### 📱 Listar Templates WABA
+Lista todos os templates disponíveis na conta WABA (WhatsApp Business API).
+1. Selecione a operação **Listar Templates WABA**
+2. Preencha:
+   - **WhatsApp ID**: ID da conexão WhatsApp WABA
+
+**Retorno exemplo:**
+```json
+[
+  {
+    "id": "123456789",
+    "name": "boas_vindas",
+    "language": "pt_BR",
+    "category": "MARKETING",
+    "status": "APPROVED",
+    "alreadyImported": true
+  },
+  {
+    "id": "987654321",
+    "name": "confirmacao_pedido",
+    "language": "pt_BR",
+    "category": "UTILITY",
+    "status": "APPROVED",
+    "alreadyImported": false
+  }
+]
+```
+
+**Campos retornados:**
+- `id`: ID do template no Facebook Graph API
+- `name`: Nome do template
+- `language`: Idioma do template
+- `category`: Categoria (MARKETING, UTILITY, AUTHENTICATION)
+- `status`: Status (APPROVED, PENDING, REJECTED)
+- `alreadyImported`: Indica se o template já foi importado no sistema
+
+### 📤 Enviar Template WABA
+Envia um template WABA pré-aprovado para um número de WhatsApp.
+1. Selecione a operação **Enviar Template WABA**
+2. Preencha:
+   - **WhatsApp ID**: ID da conexão WhatsApp WABA
+   - **Template ID**: ID do template no sistema (obtido após importação)
+   - **Número de Telefone**: Número do destinatário com DDI (ex: 5511999999999)
+   - **Parâmetros do Template**: JSON com variáveis para substituir no template (opcional)
+
+**Exemplo de parâmetros:**
+```json
+{
+  "nome_cliente": "João Silva",
+  "numero_pedido": "12345",
+  "data_entrega": "15/01/2025"
+}
+```
+
+**Retorno exemplo:**
+```json
+{
+  "success": true,
+  "message": "Template enviado com sucesso",
+  "messageId": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYIDNBNjdFRjg5RjY4OTRDNTA5MDk5",
+  "templateName": "boas_vindas",
+  "recipient": "5511999999999",
+  "whatsappId": 3
+}
+```
+
+**Observações importantes:**
+- Templates WABA precisam ser pré-aprovados pelo Meta/Facebook
+- O template deve estar importado no sistema para ser enviado
+- Use `listWabaTemplates` para ver quais templates estão disponíveis
+- Os parâmetros devem corresponder às variáveis definidas no template
+- Templates WABA são ideais para notificações, confirmações e mensagens de marketing
+
 ## 💡 Casos de Uso Práticos
 
 ### 🤖 Bot de Atendimento Interativo
@@ -703,6 +791,34 @@ Webhook (Capturar resposta)
 9. Webhook (Notificar vendedor)
 ```
 
+### 📱 Templates WABA
+**Cenário**: Notificação de pedido aprovado
+
+```
+1. Webhook (Pedido aprovado)
+    ↓
+2. Listar Templates WABA (Buscar template de confirmação)
+    ↓
+3. Enviar Template WABA (Notificar cliente)
+    ↓
+    Parâmetros: {
+      "nome_cliente": "{{$json.customer_name}}",
+      "numero_pedido": "{{$json.order_id}}",
+      "valor_total": "{{$json.total}}",
+      "data_entrega": "{{$json.delivery_date}}"
+    }
+    ↓
+4. Database (Registrar envio)
+```
+
+**Vantagens dos Templates WABA:**
+- ✅ Aprovação prévia do Meta/Facebook
+- ✅ Baixo custo de envio
+- ✅ Alta taxa de entrega
+- ✅ Ideais para notificações transacionais
+- ✅ Suporte a variáveis dinâmicas
+- ✅ Podem incluir botões e mídia
+
 ## Suporte
 
 Para suporte, entre em contato com [contato@digitalsac.io](mailto:contato@digitalsac.io).

package/dist/nodes/Digitalsac/Digitalsac.node.js

@@ -37,7 +37,7 @@ class Digitalsac {
                         { name: 'Fechar Ticket', value: 'closeTicket' },
                         { name: 'Enviar Mensagem', value: 'sendMessage' },
                         { name: 'Enviar Botões', value: 'sendButtons' },
-                        // { name: 'Enviar Lista', value: 'sendList' }, // TEMPORARIAMENTE DESABILITADO
+                        { name: 'Enviar Lista', value: 'sendList' },
                         { name: 'Enviar Mídia com Caption', value: 'sendMediaCaption' },
                         { name: 'Enviar Base64', value: 'sendBase64' },
                         { name: 'Listar Tags', value: 'listTags' },
@@ -55,6 +55,9 @@ class Digitalsac {
                         { name: 'Criar Agendamento', value: 'createSchedule' },
                         { name: 'Cancelar Agendamento', value: 'cancelSchedule' },
                         { name: 'Gerar Link do Calendário (.ics)', value: 'calendarLink' },
+                        // Templates WABA
+                        { name: 'Listar Templates WABA', value: 'listWabaTemplates' },
+                        { name: 'Enviar Template WABA', value: 'sendWabaTemplate' },
                     ],
                     default: 'validateWhatsapp',
                 },
@@ -65,7 +68,7 @@ class Digitalsac {
                     default: '',
                     displayOptions: {
                         show: {
-                            operation: ['validateWhatsapp', 'validateCpf', 'sendMessage', 'sendButtons', /* 'sendList', */ 'sendMediaCaption', 'sendBase64'],
+                            operation: ['validateWhatsapp', 'validateCpf', 'sendMessage', 'sendButtons', 'sendList', 'sendMediaCaption', 'sendBase64'],
                         },
                     },
                     description: 'Número, CPF ou UUID da conexão (conforme operação)',
@@ -113,7 +116,7 @@ class Digitalsac {
                     default: 'Digitalsac123',
                     displayOptions: {
                         show: {
-                            operation: ['sendMessage', 'sendButtons', /* 'sendList', */ 'sendMediaCaption', 'sendBase64'],
+                            operation: ['sendMessage', 'sendButtons', 'sendList', 'sendMediaCaption', 'sendBase64'],
                         },
                     },
                     description: 'Identificador único opcional para a mensagem',
@@ -167,8 +170,7 @@ class Digitalsac {
                     },
                     description: 'Array de botões em formato JSON',
                 },
-                // Campos para Enviar Lista - TEMPORARIAMENTE DESABILITADO
-                /*
+                // Campos para Enviar Lista
                 {
                     displayName: 'Título',
                     name: 'listTitle',
@@ -241,7 +243,6 @@ class Digitalsac {
                     },
                     description: 'Array de seções da lista em formato JSON',
                 },
-                */
                 // Campos para Enviar Mídia com Caption
                 {
                     displayName: 'Caption',
@@ -646,6 +647,55 @@ class Digitalsac {
                     },
                     description: 'ID do agendamento para gerar o link do calendário',
                 },
+                // Campos para Templates WABA
+                {
+                    displayName: 'WhatsApp ID',
+                    name: 'wabaWhatsappId',
+                    type: 'number',
+                    default: 1,
+                    displayOptions: {
+                        show: {
+                            operation: ['listWabaTemplates', 'sendWabaTemplate'],
+                        },
+                    },
+                    description: 'ID da conexão WhatsApp WABA',
+                },
+                {
+                    displayName: 'Template ID',
+                    name: 'wabaTemplateId',
+                    type: 'number',
+                    default: 1,
+                    displayOptions: {
+                        show: {
+                            operation: ['sendWabaTemplate'],
+                        },
+                    },
+                    description: 'ID do template no sistema (obtido após importação)',
+                },
+                {
+                    displayName: 'Número de Telefone',
+                    name: 'wabaPhoneNumber',
+                    type: 'string',
+                    default: '5511999999999',
+                    displayOptions: {
+                        show: {
+                            operation: ['sendWabaTemplate'],
+                        },
+                    },
+                    description: 'Número do destinatário com DDI (ex: 5511999999999)',
+                },
+                {
+                    displayName: 'Parâmetros do Template (JSON)',
+                    name: 'wabaTemplateParams',
+                    type: 'json',
+                    default: '{}',
+                    displayOptions: {
+                        show: {
+                            operation: ['sendWabaTemplate'],
+                        },
+                    },
+                    description: 'Parâmetros customizados para substituir variáveis no template (ex: {"nome_cliente": "João", "numero_pedido": "12345"})',
+                },
             ],
         };
     }
@@ -999,6 +1049,42 @@ class Digitalsac {
                     const calendarScheduleId = this.getNodeParameter('calendarScheduleId', i);
                     url = `/typebot/calendar-link?scheduleId=${calendarScheduleId}`;
                     break;
+                case 'listWabaTemplates':
+                    const wabaWhatsappIdForList = this.getNodeParameter('wabaWhatsappId', i);
+                    url = `/typebot/listar_templates_waba/${wabaWhatsappIdForList}`;
+                    method = 'GET';
+                    break;
+                case 'sendWabaTemplate':
+                    url = '/typebot/enviar_template_waba';
+                    method = 'POST';
+                    const wabaTemplateId = this.getNodeParameter('wabaTemplateId', i);
+                    const wabaPhoneNumber = this.getNodeParameter('wabaPhoneNumber', i);
+                    const wabaWhatsappId = this.getNodeParameter('wabaWhatsappId', i);
+                    const wabaTemplateParams = this.getNodeParameter('wabaTemplateParams', i);
+                    let parsedTemplateParams = {};
+                    if (wabaTemplateParams && wabaTemplateParams.trim() !== '' && wabaTemplateParams.trim() !== '{}') {
+                        try {
+                            parsedTemplateParams = JSON.parse(wabaTemplateParams);
+                        }
+                        catch (error) {
+                            throw new Error('Erro ao fazer parse do JSON dos parâmetros do template. Verifique a sintaxe.');
+                        }
+                    }
+                    body = {
+                        templateId: wabaTemplateId,
+                        phoneNumber: wabaPhoneNumber,
+                        whatsappId: wabaWhatsappId,
+                        templateParams: parsedTemplateParams
+                    };
+                    headers['Content-Type'] = 'application/json';
+                    options = {
+                        method,
+                        headers,
+                        body,
+                        uri: `${baseUrl}${url}`,
+                        json: true,
+                    };
+                    break;
                 case 'sendButtons':
                     // Validar se o UUID foi fornecido
                     if (!param || param.trim() === '') {
@@ -1034,32 +1120,27 @@ class Digitalsac {
                         json: true,
                     };
                     break;
-                // TEMPORARIAMENTE DESABILITADO - sendList
-                /*
                 case 'sendList':
                     // Validar se o UUID foi fornecido
                     if (!param || param.trim() === '') {
                         throw new Error('UUID da conexão é obrigatório para enviar lista. Preencha o campo "Parâmetro" com o UUID da conexão.');
                     }
-                    
                     url = `/v1/api/external/${param}/send-list`;
                     method = 'POST';
-                    
-                    const listTitle = this.getNodeParameter('listTitle', i) as string;
-                    const listText = this.getNodeParameter('listText', i) as string;
-                    const listButtonText = this.getNodeParameter('listButtonText', i) as string;
-                    const listFooter = this.getNodeParameter('listFooter', i) as string;
-                    const listPhoneNumber = this.getNodeParameter('listPhoneNumber', i) as string;
-                    const listExternalKey = this.getNodeParameter('externalKey', i) as string;
-                    const sectionsData = this.getNodeParameter('sectionsData', i) as string;
-                    
+                    const listTitle = this.getNodeParameter('listTitle', i);
+                    const listText = this.getNodeParameter('listText', i);
+                    const listButtonText = this.getNodeParameter('listButtonText', i);
+                    const listFooter = this.getNodeParameter('listFooter', i);
+                    const listPhoneNumber = this.getNodeParameter('listPhoneNumber', i);
+                    const listExternalKey = this.getNodeParameter('externalKey', i);
+                    const sectionsData = this.getNodeParameter('sectionsData', i);
                     let parsedSections;
                     try {
                         parsedSections = JSON.parse(sectionsData);
-                    } catch (error) {
+                    }
+                    catch (error) {
                         throw new Error('Erro ao fazer parse do JSON das seções. Verifique a sintaxe.');
                     }
-                    
                     body = {
                         title: listTitle,
                         text: listText,
@@ -1069,7 +1150,6 @@ class Digitalsac {
                         sections: parsedSections,
                         externalKey: listExternalKey
                     };
-                    
                     headers['Content-Type'] = 'application/json';
                     options = {
                         method,
@@ -1079,7 +1159,6 @@ class Digitalsac {
                         json: true,
                     };
                     break;
-                */
                 case 'sendMediaCaption':
                     // Validar se o UUID foi fornecido
                     if (!param || param.trim() === '') {

package/nodes/Digitalsac/Digitalsac.node.ts

@@ -42,10 +42,10 @@ export class Digitalsac implements INodeType {
 					{ name: 'Transferir para Fila', value: 'transferQueue' },
 					{ name: 'Transferir para Atendente', value: 'transferAgent' },
 					{ name: 'Fechar Ticket', value: 'closeTicket' },
-					{ name: 'Enviar Mensagem', value: 'sendMessage' },
-					{ name: 'Enviar Botões', value: 'sendButtons' },
-					// { name: 'Enviar Lista', value: 'sendList' }, // TEMPORARIAMENTE DESABILITADO
-					{ name: 'Enviar Mídia com Caption', value: 'sendMediaCaption' },
+				{ name: 'Enviar Mensagem', value: 'sendMessage' },
+				{ name: 'Enviar Botões', value: 'sendButtons' },
+				{ name: 'Enviar Lista', value: 'sendList' },
+				{ name: 'Enviar Mídia com Caption', value: 'sendMediaCaption' },
 					{ name: 'Enviar Base64', value: 'sendBase64' },
 					{ name: 'Listar Tags', value: 'listTags' },
 					{ name: 'Vincular Tag', value: 'linkTag' },
@@ -59,12 +59,15 @@ export class Digitalsac implements INodeType {
 					{ name: 'Listar Usuários Disponíveis', value: 'listAvailableUsers' },
 					{ name: 'Listar Horários Disponíveis', value: 'listAvailableSlots' },
 					{ name: 'Listar Agendamentos', value: 'listSchedules' },
-					{ name: 'Criar Agendamento', value: 'createSchedule' },
-					{ name: 'Cancelar Agendamento', value: 'cancelSchedule' },
-					{ name: 'Gerar Link do Calendário (.ics)', value: 'calendarLink' },
-				],
-				default: 'validateWhatsapp',
-			},
+				{ name: 'Criar Agendamento', value: 'createSchedule' },
+				{ name: 'Cancelar Agendamento', value: 'cancelSchedule' },
+				{ name: 'Gerar Link do Calendário (.ics)', value: 'calendarLink' },
+				// Templates WABA
+				{ name: 'Listar Templates WABA', value: 'listWabaTemplates' },
+				{ name: 'Enviar Template WABA', value: 'sendWabaTemplate' },
+			],
+			default: 'validateWhatsapp',
+		},
 			{
 				displayName: 'Parâmetro',
 				name: 'param',
@@ -72,7 +75,7 @@ export class Digitalsac implements INodeType {
 				default: '',
 				displayOptions: {
 					show: {
-						operation: ['validateWhatsapp', 'validateCpf', 'sendMessage', 'sendButtons', /* 'sendList', */ 'sendMediaCaption', 'sendBase64'],
+						operation: ['validateWhatsapp', 'validateCpf', 'sendMessage', 'sendButtons', 'sendList', 'sendMediaCaption', 'sendBase64'],
 					},
 				},
 				description: 'Número, CPF ou UUID da conexão (conforme operação)',
@@ -120,7 +123,7 @@ export class Digitalsac implements INodeType {
 				default: 'Digitalsac123',
 				displayOptions: {
 					show: {
-						operation: ['sendMessage', 'sendButtons', /* 'sendList', */ 'sendMediaCaption', 'sendBase64'],
+						operation: ['sendMessage', 'sendButtons', 'sendList', 'sendMediaCaption', 'sendBase64'],
 					},
 				},
 				description: 'Identificador único opcional para a mensagem',
@@ -174,8 +177,7 @@ export class Digitalsac implements INodeType {
 				},
 				description: 'Array de botões em formato JSON',
 			},
-			// Campos para Enviar Lista - TEMPORARIAMENTE DESABILITADO
-			/*
+			// Campos para Enviar Lista
 			{
 				displayName: 'Título',
 				name: 'listTitle',
@@ -248,7 +250,6 @@ export class Digitalsac implements INodeType {
 				},
 				description: 'Array de seções da lista em formato JSON',
 			},
-			*/
 			// Campos para Enviar Mídia com Caption
 			{
 				displayName: 'Caption',
@@ -641,19 +642,68 @@ export class Digitalsac implements INodeType {
 				},
 				description: 'ID do agendamento a ser cancelado',
 			},
-			{
-				displayName: 'ID do Agendamento',
-				name: 'calendarScheduleId',
-				type: 'number',
-				default: 0,
-				displayOptions: {
-					show: {
-						operation: ['calendarLink'],
-					},
+		{
+			displayName: 'ID do Agendamento',
+			name: 'calendarScheduleId',
+			type: 'number',
+			default: 0,
+			displayOptions: {
+				show: {
+					operation: ['calendarLink'],
 				},
-				description: 'ID do agendamento para gerar o link do calendário',
 			},
-		],
+			description: 'ID do agendamento para gerar o link do calendário',
+		},
+		// Campos para Templates WABA
+		{
+			displayName: 'WhatsApp ID',
+			name: 'wabaWhatsappId',
+			type: 'number',
+			default: 1,
+			displayOptions: {
+				show: {
+					operation: ['listWabaTemplates', 'sendWabaTemplate'],
+				},
+			},
+			description: 'ID da conexão WhatsApp WABA',
+		},
+		{
+			displayName: 'Template ID',
+			name: 'wabaTemplateId',
+			type: 'number',
+			default: 1,
+			displayOptions: {
+				show: {
+					operation: ['sendWabaTemplate'],
+				},
+			},
+			description: 'ID do template no sistema (obtido após importação)',
+		},
+		{
+			displayName: 'Número de Telefone',
+			name: 'wabaPhoneNumber',
+			type: 'string',
+			default: '5511999999999',
+			displayOptions: {
+				show: {
+					operation: ['sendWabaTemplate'],
+				},
+			},
+			description: 'Número do destinatário com DDI (ex: 5511999999999)',
+		},
+		{
+			displayName: 'Parâmetros do Template (JSON)',
+			name: 'wabaTemplateParams',
+			type: 'json',
+			default: '{}',
+			displayOptions: {
+				show: {
+					operation: ['sendWabaTemplate'],
+				},
+			},
+			description: 'Parâmetros customizados para substituir variáveis no template (ex: {"nome_cliente": "João", "numero_pedido": "12345"})',
+		},
+	],
 	};
 
 	async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
@@ -1026,12 +1076,55 @@ export class Digitalsac implements INodeType {
 					};
 					break;
 				
-				case 'calendarLink':
-					const calendarScheduleId = this.getNodeParameter('calendarScheduleId', i) as number;
-					
-					url = `/typebot/calendar-link?scheduleId=${calendarScheduleId}`;
-					break;
-				case 'sendButtons':
+			case 'calendarLink':
+				const calendarScheduleId = this.getNodeParameter('calendarScheduleId', i) as number;
+				
+				url = `/typebot/calendar-link?scheduleId=${calendarScheduleId}`;
+				break;
+			
+			case 'listWabaTemplates':
+				const wabaWhatsappIdForList = this.getNodeParameter('wabaWhatsappId', i) as number;
+				
+				url = `/typebot/listar_templates_waba/${wabaWhatsappIdForList}`;
+				method = 'GET';
+				break;
+			
+			case 'sendWabaTemplate':
+				url = '/typebot/enviar_template_waba';
+				method = 'POST';
+				
+				const wabaTemplateId = this.getNodeParameter('wabaTemplateId', i) as number;
+				const wabaPhoneNumber = this.getNodeParameter('wabaPhoneNumber', i) as string;
+				const wabaWhatsappId = this.getNodeParameter('wabaWhatsappId', i) as number;
+				const wabaTemplateParams = this.getNodeParameter('wabaTemplateParams', i) as string;
+				
+				let parsedTemplateParams = {};
+				if (wabaTemplateParams && wabaTemplateParams.trim() !== '' && wabaTemplateParams.trim() !== '{}') {
+					try {
+						parsedTemplateParams = JSON.parse(wabaTemplateParams);
+					} catch (error) {
+						throw new Error('Erro ao fazer parse do JSON dos parâmetros do template. Verifique a sintaxe.');
+					}
+				}
+				
+				body = {
+					templateId: wabaTemplateId,
+					phoneNumber: wabaPhoneNumber,
+					whatsappId: wabaWhatsappId,
+					templateParams: parsedTemplateParams
+				};
+				
+				headers['Content-Type'] = 'application/json';
+				options = {
+					method,
+					headers,
+					body,
+					uri: `${baseUrl}${url}`,
+					json: true,
+				};
+				break;
+			
+			case 'sendButtons':
 					// Validar se o UUID foi fornecido
 					if (!param || param.trim() === '') {
 						throw new Error('UUID da conexão é obrigatório para enviar botões. Preencha o campo "Parâmetro" com o UUID da conexão.');
@@ -1070,8 +1163,6 @@ export class Digitalsac implements INodeType {
 						json: true,
 					};
 					break;
-				// TEMPORARIAMENTE DESABILITADO - sendList
-				/*
 				case 'sendList':
 					// Validar se o UUID foi fornecido
 					if (!param || param.trim() === '') {
@@ -1115,7 +1206,6 @@ export class Digitalsac implements INodeType {
 						json: true,
 					};
 					break;
-				*/
 				case 'sendMediaCaption':
 					// Validar se o UUID foi fornecido
 					if (!param || param.trim() === '') {

package/package.json

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