n8n-nodes-digitalsac 0.5.5 → 0.5.7

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:
@@ -633,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
@@ -701,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

@@ -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',
                 },
@@ -82,6 +85,22 @@ class Digitalsac {
                     },
                     description: 'ID do usuário para listar kanbans',
                 },
+                {
+                    displayName: 'Formato de Resposta',
+                    name: 'agentsFormat',
+                    type: 'options',
+                    options: [
+                        { name: 'JSON Completo (Recomendado)', value: 'json' },
+                        { name: 'Texto Formatado (Compatibilidade)', value: 'string' },
+                    ],
+                    default: 'json',
+                    displayOptions: {
+                        show: {
+                            operation: ['listAgents'],
+                        },
+                    },
+                    description: 'Formato de retorno: JSON completo com todos os campos (id, name, email, phoneNumber, status, profile, isOnline, isActive, isMaster) ou texto formatado para compatibilidade',
+                },
                 {
                     displayName: 'Corpo da Mensagem',
                     name: 'messageBody',
@@ -644,6 +663,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"})',
+                },
             ],
         };
     }
@@ -694,7 +762,11 @@ class Digitalsac {
                     url = '/typebot/listar_filas';
                     break;
                 case 'listAgents':
+                    const agentsFormat = this.getNodeParameter('agentsFormat', i, 'json');
                     url = '/typebot/listar_atendentes';
+                    if (agentsFormat === 'string') {
+                        url += '?format=string';
+                    }
                     break;
                 case 'transferQueue':
                     url = '/typebot/transferir_para_fila';
@@ -997,6 +1069,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() === '') {

package/nodes/Digitalsac/Digitalsac.node.ts

@@ -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',
@@ -77,18 +80,34 @@ export class Digitalsac implements INodeType {
 				},
 				description: 'Número, CPF ou UUID da conexão (conforme operação)',
 			},
-			{
-				displayName: 'User ID',
-				name: 'userId',
-				type: 'number',
-				default: 1,
-				displayOptions: {
-					show: {
-						operation: ['listKanbans'],
-					},
+		{
+			displayName: 'User ID',
+			name: 'userId',
+			type: 'number',
+			default: 1,
+			displayOptions: {
+				show: {
+					operation: ['listKanbans'],
+				},
+			},
+			description: 'ID do usuário para listar kanbans',
+		},
+		{
+			displayName: 'Formato de Resposta',
+			name: 'agentsFormat',
+			type: 'options',
+			options: [
+				{ name: 'JSON Completo (Recomendado)', value: 'json' },
+				{ name: 'Texto Formatado (Compatibilidade)', value: 'string' },
+			],
+			default: 'json',
+			displayOptions: {
+				show: {
+					operation: ['listAgents'],
 				},
-				description: 'ID do usuário para listar kanbans',
 			},
+			description: 'Formato de retorno: JSON completo com todos os campos (id, name, email, phoneNumber, status, profile, isOnline, isActive, isMaster) ou texto formatado para compatibilidade',
+		},
 			{
 				displayName: 'Corpo da Mensagem',
 				name: 'messageBody',
@@ -639,19 +658,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[][]> {
@@ -701,12 +769,16 @@ export class Digitalsac implements INodeType {
 						json: true,
 					};
 					break;
-				case 'listQueues':
-					url = '/typebot/listar_filas';
-					break;
-				case 'listAgents':
-					url = '/typebot/listar_atendentes';
-					break;
+			case 'listQueues':
+				url = '/typebot/listar_filas';
+				break;
+			case 'listAgents':
+				const agentsFormat = this.getNodeParameter('agentsFormat', i, 'json') as string;
+				url = '/typebot/listar_atendentes';
+				if (agentsFormat === 'string') {
+					url += '?format=string';
+				}
+				break;
 				case 'transferQueue':
 					url = '/typebot/transferir_para_fila';
 					method = 'POST';
@@ -1024,12 +1096,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.');

package/package.json

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