n8n-nodes-digitalsac 0.5.7 → 0.5.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md DELETED
@@ -1,824 +0,0 @@
1
- # n8n-nodes-digitalsac
2
-
3
- Este pacote adiciona um nó personalizado ao n8n para interagir com a API do Digitalsac Izing Pro.
4
-
5
- ## Funcionalidades
6
-
7
- - Validar número de WhatsApp
8
- - Validar CPF
9
- - Validar Data
10
- - Listar Filas
11
- - Listar Atendentes
12
- - Transferir para Fila
13
- - Transferir para Atendente
14
- - Fechar Ticket
15
- - Enviar Mensagem (texto e arquivos)
16
- - **Enviar Botões Interativos**
17
- - **Enviar Listas**
18
- - **Enviar Mídia com Caption**
19
- - **Enviar Arquivo Base64**
20
- - Listar Tags
21
- - Vincular Tag
22
- - Criar Tag
23
- - Listar Kanbans
24
- - Vincular Kanban
25
- - Listar Carteiras
26
- - Vincular Carteira
27
- - **Agendamento:**
28
- - Listar Serviços
29
- - Listar Usuários Disponíveis
30
- - Listar Horários Disponíveis
31
- - Criar Agendamento
32
- - Cancelar Agendamento
33
- - Gerar Link do Calendário (.ics)
34
- - **Templates WABA:**
35
- - Listar Templates WABA
36
- - Enviar Template WABA
37
-
38
- ## Instalação
39
-
40
- ### Via interface do n8n
41
- 1. Vá para **Configurações > Community Nodes**
42
- 2. Digite `n8n-nodes-digitalsac` na caixa de pesquisa
43
- 3. Clique em **Instalar**
44
-
45
- ### Via linha de comando
46
- ```bash
47
- npm install -g n8n-nodes-digitalsac
48
- ```
49
-
50
- Ou se você estiver usando o n8n com um diretório específico:
51
- ```bash
52
- cd ~/.n8n
53
- npm install n8n-nodes-digitalsac
54
- ```
55
-
56
- ## ✨ Novas Funcionalidades (v0.5.6)
57
-
58
- ### 📱 Templates WABA
59
- Envie templates pré-aprovados do WhatsApp Business API:
60
- - **Listar Templates WABA**: Busca todos os templates disponíveis na conta WABA
61
- - **Enviar Template WABA**: Envia template com variáveis dinâmicas para contatos
62
-
63
- **Benefícios:**
64
- - ✅ Templates aprovados pelo Meta/Facebook
65
- - ✅ Baixo custo de envio
66
- - ✅ Alta taxa de entrega
67
- - ✅ Suporte a variáveis personalizadas
68
- - ✅ Ideais para notificações transacionais
69
-
70
- ## ✨ Funcionalidades Anteriores (v0.5.1)
71
-
72
- ### 🔘 Enviar Botões Interativos
73
- Envie mensagens com botões clicáveis:
74
- - **Resposta Rápida**: Botão que responde instantaneamente
75
- - **URL**: Botão que abre links
76
- - **Copiar**: Botão que copia texto
77
- - **Ligar**: Botão que inicia chamada
78
-
79
- ### 📋 Enviar Listas
80
- Crie menus organizados com:
81
- - Múltiplas seções
82
- - Opções clicáveis
83
- - Descrições detalhadas
84
-
85
- ### 🖼️ Enviar Mídia com Caption
86
- Envie arquivos com legendas personalizadas:
87
- - Upload direto de arquivos
88
- - Caption obrigatório
89
- - Suporte a imagens, PDFs, vídeos
90
-
91
- ### 📁 Enviar Base64
92
- Envie arquivos via base64:
93
- - Sem necessidade de upload
94
- - Caption opcional
95
- - Ideal para integração com APIs
96
-
97
- ## Autenticação
98
-
99
- Configure as credenciais Digitalsac com a URL base e seu Bearer Token:
100
- 1. Vá para **Credenciais > Criar Nova Credencial**
101
- 2. Selecione **Izing Pro Digitalsac API**
102
- 3. Preencha:
103
- - **API Base URL**: URL da sua instalação do Digitalsac (ex: https://seudominio.digitalsac.com.br)
104
- - **Bearer Token**: Seu token de autenticação
105
-
106
- ## Como Usar
107
-
108
- ### Validar WhatsApp
109
- 1. Selecione a operação **Validar WhatsApp**
110
- 2. No campo **Parâmetro**, insira o número de telefone a ser validado
111
-
112
- ### Validar CPF
113
- 1. Selecione a operação **Validar CPF**
114
- 2. No campo **Parâmetro**, insira o CPF a ser validado
115
-
116
- ### Validar Data
117
- 1. Selecione a operação **Validar Data**
118
- 2. No campo **Dados (JSON)**, insira os dados no formato:
119
- ```json
120
- {
121
- "data": "string com a data a ser validada"
122
- }
123
- ```
124
-
125
- ### Listar Filas/Atendentes
126
- 1. Selecione a operação **Listar Filas** ou **Listar Atendentes**
127
- 2. Não é necessário configurar parâmetros adicionais
128
-
129
- ### Transferir para Fila
130
- 1. Selecione a operação **Transferir para Fila**
131
- 2. No campo **Dados (JSON)**, insira os dados no formato:
132
- ```json
133
- {
134
- "ticketId": 0,
135
- "queueId": 0
136
- }
137
- ```
138
- Onde:
139
- - `ticketId`: ID do ticket a ser transferido
140
- - `queueId`: ID da fila de destino
141
-
142
- ### Transferir para Atendente
143
- 1. Selecione a operação **Transferir para Atendente**
144
- 2. No campo **Dados (JSON)**, insira os dados no formato:
145
- ```json
146
- {
147
- "ticketId": 0,
148
- "userId": 0
149
- }
150
- ```
151
- Onde:
152
- - `ticketId`: ID do ticket a ser transferido
153
- - `userId`: ID do atendente de destino
154
-
155
- ### Fechar Ticket
156
- 1. Selecione a operação **Fechar Ticket**
157
- 2. No campo **Dados (JSON)**, insira os dados no formato:
158
- ```json
159
- {
160
- "ticketId": 0
161
- }
162
- ```
163
- Onde:
164
- - `ticketId`: ID do ticket a ser fechado
165
-
166
- ### Enviar Mensagem de Texto
167
- 1. Selecione a operação **Enviar Mensagem**
168
- 2. No campo **Parâmetro**, insira o UUID da conexão (ex: 999ab3a2-9f1f-4ffb-969a-bfb72234ece1)
169
- 3. No campo **Corpo da Mensagem**, insira o texto da mensagem
170
- 4. No campo **Número de Telefone**, insira o número no formato DDI+DDD+Número (ex: 5511999999999)
171
- 5. No campo **Chave Externa**, insira um identificador único opcional
172
-
173
- ### Enviar Arquivo
174
- 1. Conecte um nó que forneça dados binários (ex: **HTTP Request**, **Read Binary File**, **Google Drive**)
175
- 2. Conecte ao nó **Digitalsac**
176
- 3. Selecione a operação **Enviar Mensagem**
177
- 4. No campo **Parâmetro**, insira o UUID da conexão
178
- 5. Preencha os demais campos normalmente
179
- 6. O nó detectará automaticamente o arquivo binário e enviará via FormData
180
-
181
- **Nota**: O nó detecta automaticamente se há dados binários conectados e escolhe o método correto:
182
- - **Sem arquivo**: Envia como JSON (texto)
183
- - **Com arquivo**: Envia como FormData (arquivo + texto)
184
-
185
- ### 🔘 Enviar Botões Interativos
186
- 1. Selecione a operação **Enviar Botões**
187
- 2. No campo **Parâmetro**, insira o UUID da conexão
188
- 3. Preencha os campos básicos:
189
- - **Título**: "Escolha uma opção"
190
- - **Corpo da Mensagem**: "Clique em uma das opções abaixo:"
191
- - **Número de Telefone**: "5511999999999"
192
- - **Chave Externa**: "btn_001"
193
- 4. No campo **Botões (JSON)**, configure os botões:
194
-
195
- ```json
196
- [
197
- {
198
- "tipo": {"label": "Resposta Rápida", "value": "quick_reply"},
199
- "display_text": "✅ Sim",
200
- "conteudo": "sim"
201
- },
202
- {
203
- "tipo": {"label": "Resposta Rápida", "value": "quick_reply"},
204
- "display_text": "❌ Não",
205
- "conteudo": "nao"
206
- },
207
- {
208
- "tipo": {"label": "URL", "value": "url"},
209
- "display_text": "🌐 Visitar Site",
210
- "conteudo": "https://www.digitalsac.com.br"
211
- },
212
- {
213
- "tipo": {"label": "Copiar", "value": "copy"},
214
- "display_text": "📋 Copiar Código",
215
- "conteudo": "PROMO2024"
216
- },
217
- {
218
- "tipo": {"label": "Ligar", "value": "call"},
219
- "display_text": "📞 Ligar Agora",
220
- "conteudo": "5511999999999"
221
- }
222
- ]
223
- ```
224
-
225
- **Tipos de botão disponíveis:**
226
- - `quick_reply`: Resposta rápida (o texto vai para o chat)
227
- - `url`: Abre um link no navegador
228
- - `copy`: Copia texto para área de transferência
229
- - `call`: Inicia uma chamada telefônica
230
-
231
- ### 📋 Enviar Lista
232
- 1. Selecione a operação **Enviar Lista**
233
- 2. No campo **Parâmetro**, insira o UUID da conexão
234
- 3. Preencha os campos básicos:
235
- - **Título**: "Menu de Opções"
236
- - **Texto**: "Escolha uma categoria:"
237
- - **Texto do Botão**: "Ver Opções"
238
- - **Rodapé**: "Powered by DigitalSac"
239
- - **Número de Telefone**: "5511999999999"
240
- - **Chave Externa**: "list_001"
241
- 4. No campo **Seções (JSON)**, configure as seções:
242
-
243
- ```json
244
- [
245
- {
246
- "title": "🛍️ Produtos",
247
- "lines": [
248
- {
249
- "title": "Smartphone Premium",
250
- "description": "iPhone 15 Pro Max 256GB",
251
- "rowId": 1
252
- },
253
- {
254
- "title": "Notebook Gamer",
255
- "description": "Dell Alienware com RTX 4090",
256
- "rowId": 2
257
- }
258
- ]
259
- },
260
- {
261
- "title": "🛠️ Serviços",
262
- "lines": [
263
- {
264
- "title": "Suporte Técnico",
265
- "description": "Assistência técnica especializada",
266
- "rowId": 3
267
- },
268
- {
269
- "title": "Consultoria",
270
- "description": "Consultoria personalizada",
271
- "rowId": 4
272
- }
273
- ]
274
- },
275
- {
276
- "title": "📞 Contato",
277
- "lines": [
278
- {
279
- "title": "Falar com Vendedor",
280
- "description": "Atendimento comercial",
281
- "rowId": 5
282
- }
283
- ]
284
- }
285
- ]
286
- ```
287
-
288
- ### 🖼️ Enviar Mídia com Caption
289
- 1. **Conecte um nó com arquivo** (ex: HTTP Request, Read Binary File, Google Drive)
290
- 2. Conecte ao nó **Digitalsac**
291
- 3. Selecione a operação **Enviar Mídia com Caption**
292
- 4. No campo **Parâmetro**, insira o UUID da conexão
293
- 5. Preencha os campos:
294
- - **Caption**: "Esta é uma imagem importante do produto"
295
- - **Número de Telefone**: "5511999999999"
296
- - **Chave Externa**: "media_001"
297
-
298
- **Tipos de arquivo suportados:**
299
- - 🖼️ Imagens: JPG, PNG, GIF
300
- - 📄 Documentos: PDF, DOC, DOCX
301
- - 🎥 Vídeos: MP4, AVI
302
- - 🎵 Áudio: MP3, WAV
303
-
304
- ### 📁 Enviar Base64
305
- 1. Selecione a operação **Enviar Base64**
306
- 2. No campo **Parâmetro**, insira o UUID da conexão
307
- 3. Preencha os campos:
308
- - **Caption (Opcional)**: "Documento enviado via API"
309
- - **Número de Telefone**: "5511999999999"
310
- - **Arquivo Base64**: Cole o arquivo codificado em base64
311
- - **Tipo MIME**: "application/pdf" (ou conforme o arquivo)
312
- - **Nome do Arquivo**: "documento.pdf"
313
- - **Chave Externa**: "base64_001"
314
-
315
- **Exemplo de uso com código base64:**
316
- ```json
317
- {
318
- "caption": "Relatório mensal de vendas",
319
- "mediaBase64": "JVBERi0xLjQKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQo+PgplbmRvYmoKeHJlZgowIDQKMDAwMDAwMDAwMCA2NTUzNSBmCjAwMDAwMDAwMDkgMDAwMDAgbgowMDAwMDAwMDc0IDAwMDAwIG4KMDAwMDAwMDEyMCAwMDAwMCBuCnRyYWlsZXIKPDwKL1NpemUgNAovUm9vdCAxIDAgUgo+PgpzdGFydHhyZWYKMTc5CiUlRU9G",
320
- "mimeType": "application/pdf",
321
- "fileName": "relatorio.pdf"
322
- }
323
- ```
324
-
325
- **Dica**: Para converter arquivo para base64:
326
- - **Linux/Mac**: `base64 arquivo.pdf`
327
- - **Windows**: Use PowerShell: `[Convert]::ToBase64String([IO.File]::ReadAllBytes("arquivo.pdf"))`
328
- - **Online**: Use conversores como base64encode.org
329
-
330
- ### Listar Tags
331
- 1. Selecione a operação **Listar Tags**
332
- 2. Não é necessário configurar parâmetros adicionais
333
-
334
- ### Vincular Tag
335
- 1. Selecione a operação **Vincular Tag**
336
- 2. No campo **Dados (JSON)**, insira os dados no formato:
337
- ```json
338
- {
339
- "ticketId": 123,
340
- "tagId": 456
341
- }
342
- ```
343
- Onde:
344
- - `ticketId`: ID do ticket
345
- - `tagId`: ID da tag a ser vinculada
346
-
347
- ### Criar Tag
348
- 1. Selecione a operação **Criar Tag**
349
- 2. No campo **Nome da Tag**, insira o nome da tag
350
- 3. No campo **Cor da Tag**, insira a cor em formato hexadecimal (ex: #FF5733, #2196F3, #4CAF50)
351
-
352
- ### Listar Kanbans
353
- 1. Selecione a operação **Listar Kanbans**
354
- 2. No campo **User ID**, insira o ID do usuário
355
-
356
- ### Vincular Kanban
357
- 1. Selecione a operação **Vincular Kanban**
358
- 2. No campo **Dados (JSON)**, insira os dados no formato:
359
- ```json
360
- {
361
- "ticketId": 123,
362
- "kanbanId": 456,
363
- "userId": 789
364
- }
365
- ```
366
- Onde:
367
- - `ticketId`: ID do ticket
368
- - `kanbanId`: ID do kanban a ser vinculado
369
- - `userId`: ID do usuário
370
-
371
- ### Listar Carteiras
372
- 1. Selecione a operação **Listar Carteiras**
373
- 2. Não é necessário configurar parâmetros adicionais
374
-
375
- ### Vincular Carteira
376
- 1. Selecione a operação **Vincular Carteira**
377
- 2. No campo **Dados (JSON)**, insira os dados no formato:
378
- ```json
379
- {
380
- "ticketId": 123,
381
- "userId": 456
382
- }
383
- ```
384
- Onde:
385
- - `ticketId`: ID do ticket
386
- - `userId`: ID do usuário da carteira
387
-
388
- ## Exemplos de Respostas da API
389
-
390
- ### Transferir para Fila
391
- **Resposta de sucesso:**
392
- ```json
393
- {
394
- "status": 0
395
- }
396
- ```
397
-
398
- ### Transferir para Atendente
399
- **Resposta de sucesso:**
400
- ```json
401
- {
402
- "status": 0
403
- }
404
- ```
405
-
406
- ### Fechar Ticket
407
- **Resposta de sucesso:**
408
- ```json
409
- "string"
410
- ```
411
-
412
- ### Validar Data
413
- **Resposta de sucesso:**
414
- ```json
415
- {
416
- "status": 0
417
- }
418
- ```
419
-
420
- ### Criar Tag
421
- **Resposta de sucesso (tag criada):**
422
- ```json
423
- {
424
- "status": 1,
425
- "tagId": 456
426
- }
427
- ```
428
-
429
- **Resposta quando tag já existe:**
430
- ```json
431
- {
432
- "status": 2
433
- }
434
- ```
435
-
436
- **Resposta de erro:**
437
- ```json
438
- {
439
- "status": 0
440
- }
441
- ```
442
-
443
- ### Vincular Tag/Kanban/Carteira
444
- **Resposta de sucesso:**
445
- ```json
446
- {
447
- "status": 0
448
- }
449
- ```
450
-
451
- ## Exemplo de Fluxo
452
-
453
- ### Enviar PDF para um contato
454
- 1. Adicione um nó **Read Binary File**
455
- - Configure para ler um arquivo PDF
456
- 2. Conecte ao nó **Digitalsac**
457
- - Operação: **Enviar Mensagem**
458
- - Parâmetro: `999ab3a2-9f1f-4ffb-969a-bfb72234ece1` (seu UUID de conexão)
459
- - Corpo da Mensagem: `Segue o PDF solicitado`
460
- - Número de Telefone: `5511999999999`
461
- - Chave Externa: `pdf_documento_123`
462
-
463
- ### Transferir ticket para uma fila específica
464
- 1. Adicione um nó **Digitalsac**
465
- - Operação: **Transferir para Fila**
466
- - Dados (JSON):
467
- ```json
468
- {
469
- "ticketId": 123,
470
- "queueId": 5
471
- }
472
- ```
473
-
474
- ### Transferir ticket para um atendente específico
475
- 1. Adicione um nó **Digitalsac**
476
- - Operação: **Transferir para Atendente**
477
- - Dados (JSON):
478
- ```json
479
- {
480
- "ticketId": 123,
481
- "userId": 10
482
- }
483
- ```
484
-
485
- ### Criar uma tag e vincular a um ticket
486
- 1. Adicione um nó **Digitalsac**
487
- - Operação: **Criar Tag**
488
- - Nome da Tag: `Suporte Técnico`
489
- - Cor da Tag: `#2196F3`
490
- 2. Conecte a outro nó **Digitalsac**
491
- - Operação: **Vincular Tag**
492
- - Dados (JSON):
493
- ```json
494
- {
495
- "ticketId": 123,
496
- "tagId": "{{$json.tagId}}"
497
- }
498
- ```
499
-
500
- ### Listar kanbans de um usuário e vincular a um ticket
501
- 1. Adicione um nó **Digitalsac**
502
- - Operação: **Listar Kanbans**
503
- - User ID: `10`
504
- 2. Conecte a outro nó **Digitalsac**
505
- - Operação: **Vincular Kanban**
506
- - Dados (JSON):
507
- ```json
508
- {
509
- "ticketId": 123,
510
- "kanbanId": 5,
511
- "userId": 10
512
- }
513
- ```
514
-
515
- ### Vincular carteira a um ticket
516
- 1. Adicione um nó **Digitalsac**
517
- - Operação: **Vincular Carteira**
518
- - Dados (JSON):
519
- ```json
520
- {
521
- "ticketId": 123,
522
- "userId": 15
523
- }
524
- ```
525
-
526
- ### Gerar link de calendário para um agendamento
527
- 1. Adicione um nó **Digitalsac**
528
- - Operação: **Gerar Link do Calendário (.ics)**
529
- - ID do Agendamento: `123`
530
- 2. O retorno pode ser usado para:
531
- - Enviar o link direto para o cliente
532
- - Fazer download automático do arquivo .ics
533
- - Integrar com outros sistemas de calendário
534
-
535
- ## Funcionalidades de Agendamento
536
-
537
- ### Listar Serviços
538
- Lista todos os serviços disponíveis para agendamento.
539
- 1. Selecione a operação **Listar Serviços**
540
- 2. (Opcional) No campo **ID do Usuário**, insira o ID do usuário para filtrar apenas os serviços que ele atende
541
-
542
- **Retorno exemplo:**
543
- ```json
544
- {
545
- "servicos": "*1* - Consulta (30min - R$ 100,00)\n*2* - Retorno (15min - R$ 50,00)"
546
- }
547
- ```
548
-
549
- ### Listar Usuários Disponíveis
550
- Lista os usuários/atendentes disponíveis para um serviço em uma data específica.
551
- 1. Selecione a operação **Listar Usuários Disponíveis**
552
- 2. Preencha:
553
- - **ID do Serviço**: ID do serviço desejado
554
- - **Data**: Data no formato YYYY-MM-DD (ex: 2025-08-07)
555
- - **Horário** (opcional): Horário específico no formato HH:mm (ex: 09:00)
556
-
557
- **Retorno exemplo:**
558
- ```json
559
- {
560
- "usuarios": "*28* - João Silva\n*29* - Maria Santos"
561
- }
562
- ```
563
-
564
- ### Listar Horários Disponíveis
565
- Lista os horários disponíveis para um serviço e usuário em uma data específica.
566
- 1. Selecione a operação **Listar Horários Disponíveis**
567
- 2. Preencha:
568
- - **ID do Serviço**: ID do serviço desejado
569
- - **ID do Usuário**: ID do atendente/usuário
570
- - **Data**: Data no formato YYYY-MM-DD
571
-
572
- **Retorno exemplo:**
573
- ```json
574
- {
575
- "horarios": "*1* - 09:00\n*2* - 09:30\n*3* - 10:00\n*4* - 10:30"
576
- }
577
- ```
578
-
579
- ### Criar Agendamento
580
- Cria um novo agendamento no sistema.
581
- 1. Selecione a operação **Criar Agendamento**
582
- 2. Preencha:
583
- - **ID do Serviço**: ID do serviço
584
- - **ID do Usuário**: ID do atendente/usuário
585
- - **Data**: Data do agendamento (YYYY-MM-DD)
586
- - **Horário**: Horário do agendamento (HH:mm)
587
- - **Nome do Contato**: Nome do cliente
588
- - **Telefone do Contato**: Telefone do cliente (formato: 5511999999999)
589
- - **Observações** (opcional): Notas sobre o agendamento
590
- - **ID da Conexão WhatsApp** (opcional): ID da conexão WhatsApp (usa primeira disponível se não informado)
591
- - **Mensagem Personalizada** (opcional): Mensagem personalizada do agendamento
592
- - **Lembretes (minutos)**: Lembretes em minutos antes do agendamento (separados por vírgula, ex: 60,240,1440)
593
- - **Duração do Intervalo (minutos)**: Duração do intervalo em minutos (padrão: 30)
594
- - **Fechar Ticket**: Se deve fechar o ticket após criar agendamento
595
-
596
- **Observações importantes:**
597
- - Se o contato não existir no sistema, ele será criado automaticamente
598
- - Se não informar conexão WhatsApp, será usada a primeira disponível
599
- - Os lembretes são em minutos (60 = 1 hora, 240 = 4 horas, 1440 = 1 dia)
600
-
601
- **Retorno exemplo:**
602
- ```json
603
- {
604
- "status": 1,
605
- "mensagem": "Agendamento criado com sucesso",
606
- "scheduleId": 123,
607
- "contactId": 456,
608
- "whatsappId": 789
609
- }
610
- ```
611
-
612
- ### Cancelar Agendamento
613
- Cancela um agendamento existente.
614
- 1. Selecione a operação **Cancelar Agendamento**
615
- 2. Preencha:
616
- - **ID do Agendamento**: ID do agendamento a ser cancelado
617
-
618
- **Retorno exemplo:**
619
- ```json
620
- {
621
- "status": 0,
622
- "mensagem": "Agendamento cancelado com sucesso"
623
- }
624
- ```
625
-
626
- ### Gerar Link do Calendário (.ics)
627
- Gera um link para download do arquivo .ics (calendário) de um agendamento específico.
628
- 1. Selecione a operação **Gerar Link do Calendário (.ics)**
629
- 2. Preencha:
630
- - **ID do Agendamento**: ID do agendamento para gerar o link do calendário
631
-
632
- **Retorno exemplo:**
633
- ```json
634
- {
635
- "status": 1,
636
- "link": "https://seudominio.com/schedules/123/ics",
637
- "scheduleId": 123,
638
- "info": {
639
- "cliente": "João Silva",
640
- "servico": "Consulta Médica",
641
- "data": "2025-01-15T14:30:00.000Z",
642
- "funcionario": "Dr. Pedro Santos"
643
- }
644
- }
645
- ```
646
-
647
- **Uso do link:**
648
- - O link gerado pode ser usado diretamente para download do arquivo .ics
649
- - O arquivo .ics contém todas as informações do agendamento
650
- - Pode ser importado em qualquer aplicativo de calendário (Google Calendar, Outlook, Apple Calendar, etc.)
651
- - É útil para integração com sistemas externos ou envio para clientes
652
-
653
- ### 📱 Listar Templates WABA
654
- Lista todos os templates disponíveis na conta WABA (WhatsApp Business API).
655
- 1. Selecione a operação **Listar Templates WABA**
656
- 2. Preencha:
657
- - **WhatsApp ID**: ID da conexão WhatsApp WABA
658
-
659
- **Retorno exemplo:**
660
- ```json
661
- [
662
- {
663
- "id": "123456789",
664
- "name": "boas_vindas",
665
- "language": "pt_BR",
666
- "category": "MARKETING",
667
- "status": "APPROVED",
668
- "alreadyImported": true
669
- },
670
- {
671
- "id": "987654321",
672
- "name": "confirmacao_pedido",
673
- "language": "pt_BR",
674
- "category": "UTILITY",
675
- "status": "APPROVED",
676
- "alreadyImported": false
677
- }
678
- ]
679
- ```
680
-
681
- **Campos retornados:**
682
- - `id`: ID do template no Facebook Graph API
683
- - `name`: Nome do template
684
- - `language`: Idioma do template
685
- - `category`: Categoria (MARKETING, UTILITY, AUTHENTICATION)
686
- - `status`: Status (APPROVED, PENDING, REJECTED)
687
- - `alreadyImported`: Indica se o template já foi importado no sistema
688
-
689
- ### 📤 Enviar Template WABA
690
- Envia um template WABA pré-aprovado para um número de WhatsApp.
691
- 1. Selecione a operação **Enviar Template WABA**
692
- 2. Preencha:
693
- - **WhatsApp ID**: ID da conexão WhatsApp WABA
694
- - **Template ID**: ID do template no sistema (obtido após importação)
695
- - **Número de Telefone**: Número do destinatário com DDI (ex: 5511999999999)
696
- - **Parâmetros do Template**: JSON com variáveis para substituir no template (opcional)
697
-
698
- **Exemplo de parâmetros:**
699
- ```json
700
- {
701
- "nome_cliente": "João Silva",
702
- "numero_pedido": "12345",
703
- "data_entrega": "15/01/2025"
704
- }
705
- ```
706
-
707
- **Retorno exemplo:**
708
- ```json
709
- {
710
- "success": true,
711
- "message": "Template enviado com sucesso",
712
- "messageId": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYIDNBNjdFRjg5RjY4OTRDNTA5MDk5",
713
- "templateName": "boas_vindas",
714
- "recipient": "5511999999999",
715
- "whatsappId": 3
716
- }
717
- ```
718
-
719
- **Observações importantes:**
720
- - Templates WABA precisam ser pré-aprovados pelo Meta/Facebook
721
- - O template deve estar importado no sistema para ser enviado
722
- - Use `listWabaTemplates` para ver quais templates estão disponíveis
723
- - Os parâmetros devem corresponder às variáveis definidas no template
724
- - Templates WABA são ideais para notificações, confirmações e mensagens de marketing
725
-
726
- ## 💡 Casos de Uso Práticos
727
-
728
- ### 🤖 Bot de Atendimento Interativo
729
- Combine as novas operações para criar um fluxo completo:
730
-
731
- 1. **Enviar Botões** → Menu inicial com opções
732
- 2. **Enviar Lista** → Catálogo de produtos/serviços
733
- 3. **Enviar Mídia** → Imagens dos produtos
734
- 4. **Enviar Base64** → Contratos/documentos
735
-
736
- ### 🛒 E-commerce Automation
737
- ```
738
- Trigger (Webhook)
739
-
740
- Enviar Botões (Confirmar pedido?)
741
-
742
- Enviar Lista (Formas de pagamento)
743
-
744
- Enviar Base64 (Contrato PDF)
745
-
746
- Enviar Mídia (Comprovante)
747
- ```
748
-
749
- ### 📊 Relatórios Automatizados
750
- ```
751
- Scheduler (Diário)
752
-
753
- HTTP Request (Buscar dados)
754
-
755
- Code (Gerar gráfico base64)
756
-
757
- Enviar Base64 (Relatório visual)
758
- ```
759
-
760
- ### 🎯 Marketing Campaigns
761
- ```
762
- Database (Lista clientes)
763
-
764
- Loop (Para cada cliente)
765
-
766
- Enviar Botões (CTA personalizado)
767
-
768
- Webhook (Capturar resposta)
769
- ```
770
-
771
- ### 🔄 Workflow Exemplo Completo
772
- **Cenário**: Venda de produto com confirmação interativa
773
-
774
- ```
775
- 1. Webhook (Novo lead)
776
-
777
- 2. Enviar Botões ("Interesse em comprar?")
778
-
779
- 3. IF (Resposta = "Sim")
780
-
781
- 4. Enviar Lista (Catálogo produtos)
782
-
783
- 5. HTTP Request (Buscar detalhes do produto)
784
-
785
- 6. Enviar Mídia (Foto do produto)
786
-
787
- 7. Enviar Botões ("Fechar pedido?")
788
-
789
- 8. Enviar Base64 (Contrato PDF)
790
-
791
- 9. Webhook (Notificar vendedor)
792
- ```
793
-
794
- ### 📱 Templates WABA
795
- **Cenário**: Notificação de pedido aprovado
796
-
797
- ```
798
- 1. Webhook (Pedido aprovado)
799
-
800
- 2. Listar Templates WABA (Buscar template de confirmação)
801
-
802
- 3. Enviar Template WABA (Notificar cliente)
803
-
804
- Parâmetros: {
805
- "nome_cliente": "{{$json.customer_name}}",
806
- "numero_pedido": "{{$json.order_id}}",
807
- "valor_total": "{{$json.total}}",
808
- "data_entrega": "{{$json.delivery_date}}"
809
- }
810
-
811
- 4. Database (Registrar envio)
812
- ```
813
-
814
- **Vantagens dos Templates WABA:**
815
- - ✅ Aprovação prévia do Meta/Facebook
816
- - ✅ Baixo custo de envio
817
- - ✅ Alta taxa de entrega
818
- - ✅ Ideais para notificações transacionais
819
- - ✅ Suporte a variáveis dinâmicas
820
- - ✅ Podem incluir botões e mídia
821
-
822
- ## Suporte
823
-
824
- Para suporte, entre em contato com [contato@digitalsac.io](mailto:contato@digitalsac.io).