n8n-nodes-digitalsac 0.2.0 → 0.2.4

package/README.md

@@ -1,6 +1,6 @@
 # n8n-nodes-digitalsac
 
-Este pacote adiciona um nó personalizado ao n8n para interagir com a API do Digitalsac.
+Este pacote adiciona um nó personalizado ao n8n para interagir com a API do Digitalsac Izing Pro.
 
 ## Funcionalidades
 
@@ -12,13 +12,193 @@ Este pacote adiciona um nó personalizado ao n8n para interagir com a API do Dig
 - Transferir para Fila
 - Transferir para Atendente
 - Fechar Ticket
+- Enviar Mensagem (texto e arquivos)
 
 ## Instalação
 
+### Via interface do n8n
+1. Vá para **Configurações > Community Nodes**
+2. Digite `n8n-nodes-digitalsac` na caixa de pesquisa
+3. Clique em **Instalar**
+
+### Via linha de comando
 ```bash
+npm install -g n8n-nodes-digitalsac
+```
+
+Ou se você estiver usando o n8n com um diretório específico:
+```bash
+cd ~/.n8n
 npm install n8n-nodes-digitalsac
 ```
 
 ## Autenticação
 
-Configure as credenciais Digitalsac com a URL base e seu Bearer Token.
+Configure as credenciais Digitalsac com a URL base e seu Bearer Token:
+1. Vá para **Credenciais > Criar Nova Credencial**
+2. Selecione **Izing Pro Digitalsac API**
+3. Preencha:
+   - **API Base URL**: URL da sua instalação do Digitalsac (ex: https://seudominio.digitalsac.com.br)
+   - **Bearer Token**: Seu token de autenticação
+
+## Como Usar
+
+### Validar WhatsApp
+1. Selecione a operação **Validar WhatsApp**
+2. No campo **Parâmetro**, insira o número de telefone a ser validado
+
+### Validar CPF
+1. Selecione a operação **Validar CPF**
+2. No campo **Parâmetro**, insira o CPF a ser validado
+
+### Validar Data
+1. Selecione a operação **Validar Data**
+2. No campo **Dados (JSON)**, insira os dados no formato:
+```json
+{
+  "data": "string com a data a ser validada"
+}
+```
+
+### Listar Filas/Atendentes
+1. Selecione a operação **Listar Filas** ou **Listar Atendentes**
+2. Não é necessário configurar parâmetros adicionais
+
+### Transferir para Fila
+1. Selecione a operação **Transferir para Fila**
+2. No campo **Dados (JSON)**, insira os dados no formato:
+```json
+{
+  "ticketId": 0,
+  "queueId": 0
+}
+```
+Onde:
+- `ticketId`: ID do ticket a ser transferido
+- `queueId`: ID da fila de destino
+
+### Transferir para Atendente
+1. Selecione a operação **Transferir para Atendente**
+2. No campo **Dados (JSON)**, insira os dados no formato:
+```json
+{
+  "ticketId": 0,
+  "userId": 0
+}
+```
+Onde:
+- `ticketId`: ID do ticket a ser transferido
+- `userId`: ID do atendente de destino
+
+### Fechar Ticket
+1. Selecione a operação **Fechar Ticket**
+2. No campo **Dados (JSON)**, insira os dados no formato:
+```json
+{
+  "ticketId": 0
+}
+```
+Onde:
+- `ticketId`: ID do ticket a ser fechado
+
+### Enviar Mensagem de Texto
+1. Selecione a operação **Enviar Mensagem**
+2. No campo **Parâmetro**, insira o UUID da conexão
+3. No campo **Dados (JSON)**, insira os dados no formato:
+```json
+{
+  "body": "Sua mensagem aqui",
+  "number": "5511999999999",
+  "externalKey": "chave_opcional"
+}
+```
+
+### Enviar Arquivo
+1. Conecte um nó que forneça dados binários (ex: HTTP Request, Read Binary File)
+2. Selecione a operação **Enviar Mensagem**
+3. No campo **Parâmetro**, insira o UUID da conexão
+4. No campo **Dados (JSON)**, insira os dados no formato:
+```json
+{
+  "body": "Mensagem que acompanha o arquivo",
+  "number": "5511999999999",
+  "externalKey": "chave_opcional",
+  "binaryPropertyName": "data"
+}
+```
+Onde `data` é o nome da propriedade binária que contém o arquivo.
+
+## Exemplos de Respostas da API
+
+### Transferir para Fila
+**Resposta de sucesso:**
+```json
+{
+  "status": 0
+}
+```
+
+### Transferir para Atendente
+**Resposta de sucesso:**
+```json
+{
+  "status": 0
+}
+```
+
+### Fechar Ticket
+**Resposta de sucesso:**
+```json
+"string"
+```
+
+### Validar Data
+**Resposta de sucesso:**
+```json
+{
+  "status": 0
+}
+```
+
+## Exemplo de Fluxo
+
+### Enviar PDF para um contato
+1. Adicione um nó **Read Binary File**
+   - Configure para ler um arquivo PDF
+2. Conecte ao nó **Digitalsac**
+   - Operação: **Enviar Mensagem**
+   - Parâmetro: `seu-uuid-de-conexão`
+   - Dados (JSON):
+   ```json
+   {
+     "body": "Segue o PDF solicitado",
+     "number": "5511999999999",
+     "binaryPropertyName": "data"
+   }
+   ```
+
+### Transferir ticket para uma fila específica
+1. Adicione um nó **Digitalsac**
+   - Operação: **Transferir para Fila**
+   - Dados (JSON):
+   ```json
+   {
+     "ticketId": 123,
+     "queueId": 5
+   }
+   ```
+
+### Transferir ticket para um atendente específico
+1. Adicione um nó **Digitalsac**
+   - Operação: **Transferir para Atendente**
+   - Dados (JSON):
+   ```json
+   {
+     "ticketId": 123,
+     "userId": 10
+   }
+   ```
+
+## Suporte
+
+Para suporte, entre em contato com [contato@digitalsac.io](mailto:contato@digitalsac.io).

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

@@ -49,19 +49,19 @@ class Digitalsac {
                             operation: ['validateWhatsapp', 'validateCpf', 'sendMessage'],
                         },
                     },
-                    description: 'Número, CPF ou UUID da conexão (conforme operação)',
+                    description: 'Número, CPF ou UUID da mensagem (conforme operação)',
                 },
                 {
                     displayName: 'Dados (JSON)',
                     name: 'bodyData',
                     type: 'json',
-                    default: '{\n  "body": "Mensagem a ser enviada",\n  "number": "5511999999999",\n  "externalKey": "chave_opcional"\n  // Para enviar arquivo, adicione: "binaryPropertyName": "data"\n}',
+                    default: '{"body": "Mensagem de teste", "number": "5511999999999", "externalKey": "chave123"}',
                     displayOptions: {
                         show: {
                             operation: ['validateDate', 'transferQueue', 'transferAgent', 'closeTicket', 'sendMessage'],
                         },
                     },
-                    description: 'Para enviar mensagem: {"body": "texto", "number": "5511999999999", "externalKey": "opcional"}. Para enviar arquivo, adicione "binaryPropertyName": "data" (onde "data" é o nome da propriedade binária)',
+                    description: 'Dados no formato JSON',
                 },
             ],
         };
@@ -77,32 +77,32 @@ class Digitalsac {
             let responseData;
             const headers = {
                 Authorization: `Bearer ${token}`,
-                'Content-Type': 'application/json',
                 Accept: 'application/json',
             };
             let url = '';
             let method = 'GET';
             let body;
-            let param = '';
+            let param = this.getNodeParameter('param', i, '');
             let options = {};
-            let isFormData = false;
-            let formDataFields = {};
-            let binaryData;
-            let binaryFileName;
-            let binaryContentType;
             switch (operation) {
                 case 'validateWhatsapp':
-                    param = this.getNodeParameter('param', i);
                     url = `/typebot/whatsappnumber/${param}`;
                     break;
                 case 'validateCpf':
-                    param = this.getNodeParameter('param', i);
                     url = `/typebot/validate/cpf/${param}`;
                     break;
                 case 'validateDate':
                     url = '/typebot/validate/data';
                     method = 'POST';
-                    body = this.getNodeParameter('bodyData', i);
+                    body = JSON.parse(this.getNodeParameter('bodyData', i));
+                    headers['Content-Type'] = 'application/json';
+                    options = {
+                        method,
+                        headers,
+                        body: JSON.stringify(body),
+                        uri: `${baseUrl}${url}`,
+                        json: true,
+                    };
                     break;
                 case 'listQueues':
                     url = '/typebot/listar_filas';
@@ -113,116 +113,76 @@ class Digitalsac {
                 case 'transferQueue':
                     url = '/typebot/transferir_para_fila';
                     method = 'POST';
-                    body = this.getNodeParameter('bodyData', i);
+                    body = JSON.parse(this.getNodeParameter('bodyData', i));
+                    headers['Content-Type'] = 'application/json';
+                    options = {
+                        method,
+                        headers,
+                        body: JSON.stringify(body),
+                        uri: `${baseUrl}${url}`,
+                        json: true,
+                    };
                     break;
                 case 'transferAgent':
                     url = '/typebot/transferir_para_atendente';
                     method = 'POST';
-                    body = this.getNodeParameter('bodyData', i);
+                    body = JSON.parse(this.getNodeParameter('bodyData', i));
+                    headers['Content-Type'] = 'application/json';
+                    options = {
+                        method,
+                        headers,
+                        body: JSON.stringify(body),
+                        uri: `${baseUrl}${url}`,
+                        json: true,
+                    };
                     break;
                 case 'closeTicket':
                     url = '/typebot/fechar_ticket';
                     method = 'POST';
-                    body = this.getNodeParameter('bodyData', i);
+                    body = JSON.parse(this.getNodeParameter('bodyData', i));
+                    headers['Content-Type'] = 'application/json';
+                    options = {
+                        method,
+                        headers,
+                        body: JSON.stringify(body),
+                        uri: `${baseUrl}${url}`,
+                        json: true,
+                    };
                     break;
                 case 'sendMessage':
-                    // Obter UUID da conexão do campo parâmetro
-                    const uuid = this.getNodeParameter('param', i);
-                    url = `/v1/api/external/${uuid}`;
+                    url = `/v1/api/external/${param}`;
                     method = 'POST';
-                    // Verificar se há dados binários (para envio de arquivo)
-                    const binaryPropertyName = this.getNodeParameter('binaryPropertyName', i, '');
-                    let hasBinaryData = false;
-                    if (binaryPropertyName && items[i].binary) {
-                        const binary = items[i].binary;
-                        hasBinaryData = binary[binaryPropertyName] !== undefined;
-                    }
-                    // Obter dados do corpo da mensagem
-                    const messageData = this.getNodeParameter('bodyData', i, '{}');
-                    let messageBody = {};
-                    try {
-                        // Tentar fazer parse do JSON
-                        if (typeof messageData === 'string') {
-                            messageBody = JSON.parse(messageData);
-                        }
-                        else {
-                            messageBody = messageData;
-                        }
-                    }
-                    catch (error) {
-                        // Se falhar, usar como está
-                        messageBody = { body: messageData };
-                    }
-                    // Se não tiver dados binários, enviar como JSON normal
-                    if (!hasBinaryData) {
-                        body = messageBody;
-                    }
-                    else {
-                        // Configurar para envio de arquivo
-                        isFormData = true;
-                        formDataFields = messageBody;
-                        // Preparar arquivo binário
-                        if (items[i].binary) {
-                            const binaryKeyData = items[i].binary;
-                            if (binaryKeyData[binaryPropertyName]) {
-                                const binaryProperty = binaryKeyData[binaryPropertyName];
-                                binaryData = await this.helpers.getBinaryDataBuffer(i, binaryPropertyName);
-                                binaryFileName = binaryProperty.fileName || 'file';
-                                binaryContentType = binaryProperty.mimeType;
-                            }
-                            else {
-                                throw new Error(`Nenhum dado binário encontrado na propriedade "${binaryPropertyName}"`);
-                            }
-                        }
-                        headers['Content-Type'] = 'multipart/form-data';
-                        options = {
-                            formData: true,
-                        };
-                    }
+                    body = JSON.parse(this.getNodeParameter('bodyData', i));
+                    headers['Content-Type'] = 'application/json';
+                    options = {
+                        method,
+                        headers,
+                        body: JSON.stringify(body),
+                        uri: `${baseUrl}${url}`,
+                        json: true,
+                    };
                     break;
             }
-            // Configurar opções da requisição
-            const requestOptions = {
-                method,
-                headers,
-                uri: `${baseUrl}${url}`,
-                json: true,
-            };
-            // Adicionar body quando necessário
-            if (body && !isFormData) {
-                requestOptions.body = body;
+            // Se as opções não foram definidas no switch, defina-as aqui para operações GET
+            if (!options.method) {
+                options = {
+                    method,
+                    headers,
+                    uri: `${baseUrl}${url}`,
+                    json: true,
+                };
             }
-            // Configurar FormData quando necessário
-            if (isFormData) {
-                const formData = {};
-                // Adicionar campos de texto
-                Object.entries(formDataFields).forEach(([key, value]) => {
-                    formData[key] = value;
-                });
-                // Adicionar arquivo se disponível
-                if (binaryData && binaryFileName) {
-                    formData.media = {
-                        value: binaryData,
-                        options: {
-                            filename: binaryFileName,
-                            contentType: binaryContentType,
-                        },
-                    };
-                }
-                requestOptions.formData = formData;
-            }
-            // Mesclar opções adicionais
-            Object.assign(requestOptions, options);
             try {
-                responseData = await this.helpers.request(requestOptions);
+                responseData = await this.helpers.request(options);
                 returnData.push({ json: responseData });
             }
             catch (error) {
-                if (this.continueOnFail()) {
+                if (error.response) {
+                    returnData.push({ json: { error: error.response.body } });
+                }
+                else {
                     returnData.push({ json: { error: error.message } });
-                    continue;
                 }
-                throw error;
             }
         }
         return [returnData];

package/index.ts

@@ -0,0 +1,5 @@
+import { Digitalsac } from './nodes/Digitalsac/Digitalsac.node';
+import { DigitalsacApi } from './credentials/DigitalsacApi.credentials';
+
+export const nodes = [Digitalsac];
+export const credentials = [DigitalsacApi];

package/nodes/Digitalsac/Digitalsac.node.ts

@@ -0,0 +1,201 @@
+import {
+	IExecuteFunctions,
+	INodeExecutionData,
+	INodeType,
+	INodeTypeDescription,
+	NodeConnectionType,
+} from 'n8n-workflow';
+
+export class Digitalsac implements INodeType {
+	description: INodeTypeDescription = {
+		displayName: 'Digitalsac Izing Pro',
+		name: 'digitalsac',
+		icon: 'file:digitalsac.svg',
+		group: ['transform'],
+		version: 1,
+		description: 'Interage com a API do Digitalsac',
+		defaults: {
+			name: 'Digitalsac',
+		},
+		inputs: <NodeConnectionType[]>['main'],
+		outputs: <NodeConnectionType[]>['main'],
+		
+		credentials: [
+			{
+				name: 'digitalsacApi',
+				required: true,
+			},
+		],
+		properties: [
+			{
+				displayName: 'Operação',
+				name: 'operation',
+				type: 'options',
+				options: [
+					{ name: 'Validar WhatsApp', value: 'validateWhatsapp' },
+					{ name: 'Validar CPF', value: 'validateCpf' },
+					{ name: 'Validar Data', value: 'validateDate' },
+					{ name: 'Listar Filas', value: 'listQueues' },
+					{ name: 'Listar Atendentes', value: 'listAgents' },
+					{ name: 'Transferir para Fila', value: 'transferQueue' },
+					{ name: 'Transferir para Atendente', value: 'transferAgent' },
+					{ name: 'Fechar Ticket', value: 'closeTicket' },
+					{ name: 'Enviar Mensagem', value: 'sendMessage' },
+				],
+				default: 'validateWhatsapp',
+			},
+			{
+				displayName: 'Parâmetro',
+				name: 'param',
+				type: 'string',
+				default: '',
+				displayOptions: {
+					show: {
+						operation: ['validateWhatsapp', 'validateCpf', 'sendMessage'],
+					},
+				},
+				description: 'Número, CPF ou UUID da mensagem (conforme operação)',
+			},
+			{
+				displayName: 'Dados (JSON)',
+				name: 'bodyData',
+				type: 'json',
+				default: '{"body": "Mensagem de teste", "number": "5511999999999", "externalKey": "chave123"}',
+				displayOptions: {
+					show: {
+						operation: ['validateDate', 'transferQueue', 'transferAgent', 'closeTicket', 'sendMessage'],
+					},
+				},
+				description: 'Dados no formato JSON',
+			},
+		],
+	};
+
+	async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
+		const items = this.getInputData();
+		const returnData: INodeExecutionData[] = [];
+
+		const credentials = await this.getCredentials('digitalsacApi');
+		const baseUrl = credentials.baseUrl;
+		const token = credentials.token;
+
+		for (let i = 0; i < items.length; i++) {
+			const operation = this.getNodeParameter('operation', i) as string;
+			let responseData;
+
+			const headers: Record<string, string> = {
+				Authorization: `Bearer ${token}`,
+				Accept: 'application/json',
+			};
+
+			let url = '';
+			let method: 'GET' | 'POST' = 'GET';
+			let body;
+			let param = this.getNodeParameter('param', i, '') as string;
+			let options: Record<string, any> = {};
+
+			switch (operation) {
+				case 'validateWhatsapp':
+					url = `/typebot/whatsappnumber/${param}`;
+					break;
+				case 'validateCpf':
+					url = `/typebot/validate/cpf/${param}`;
+					break;
+				case 'validateDate':
+					url = '/typebot/validate/data';
+					method = 'POST';
+					body = JSON.parse(this.getNodeParameter('bodyData', i) as string);
+					headers['Content-Type'] = 'application/json';
+					options = {
+						method,
+						headers,
+						body: JSON.stringify(body),
+						uri: `${baseUrl}${url}`,
+						json: true,
+					};
+					break;
+				case 'listQueues':
+					url = '/typebot/listar_filas';
+					break;
+				case 'listAgents':
+					url = '/typebot/listar_atendentes';
+					break;
+				case 'transferQueue':
+					url = '/typebot/transferir_para_fila';
+					method = 'POST';
+					body = JSON.parse(this.getNodeParameter('bodyData', i) as string);
+					headers['Content-Type'] = 'application/json';
+					options = {
+						method,
+						headers,
+						body: JSON.stringify(body),
+						uri: `${baseUrl}${url}`,
+						json: true,
+					};
+					break;
+				case 'transferAgent':
+					url = '/typebot/transferir_para_atendente';
+					method = 'POST';
+					body = JSON.parse(this.getNodeParameter('bodyData', i) as string);
+					headers['Content-Type'] = 'application/json';
+					options = {
+						method,
+						headers,
+						body: JSON.stringify(body),
+						uri: `${baseUrl}${url}`,
+						json: true,
+					};
+					break;
+				case 'closeTicket':
+					url = '/typebot/fechar_ticket';
+					method = 'POST';
+					body = JSON.parse(this.getNodeParameter('bodyData', i) as string);
+					headers['Content-Type'] = 'application/json';
+					options = {
+						method,
+						headers,
+						body: JSON.stringify(body),
+						uri: `${baseUrl}${url}`,
+						json: true,
+					};
+					break;
+				case 'sendMessage':
+					url = `/v1/api/external/${param}`;
+					method = 'POST';
+					body = JSON.parse(this.getNodeParameter('bodyData', i) as string);
+					headers['Content-Type'] = 'application/json';
+					options = {
+						method,
+						headers,
+						body: JSON.stringify(body),
+						uri: `${baseUrl}${url}`,
+						json: true,
+					};
+					break;
+			}
+
+			// Se as opções não foram definidas no switch, defina-as aqui para operações GET
+			if (!options.method) {
+				options = {
+					method,
+					headers,
+					uri: `${baseUrl}${url}`,
+					json: true,
+				};
+			}
+
+			try {
+				responseData = await this.helpers.request(options);
+				returnData.push({ json: responseData });
+			} catch (error: any) {
+				if (error.response) {
+					returnData.push({ json: { error: error.response.body } });
+				} else {
+					returnData.push({ json: { error: error.message } });
+				}
+			}
+		}
+
+		return [returnData];
+	}
+}