digitalsac

Izing Pro Digitalsac

Package Information

Released: 10/6/2025

Downloads: 31 weekly / 243 monthly

Latest Version: 0.5.5

Author: Digitalsac.io

Available Nodes

Digitalsac Izing Pro

No description available

Documentation

n8n-nodes-digitalsac

Este pacote adiciona um nó personalizado ao n8n para interagir com a API do Digitalsac Izing Pro.

Funcionalidades

Validar número de WhatsApp
Validar CPF
Validar Data
Listar Filas
Listar Atendentes
Transferir para Fila
Transferir para Atendente
Fechar Ticket
Enviar Mensagem (texto e arquivos)
Enviar Botões Interativos
Enviar Listas
Enviar Mídia com Caption
Enviar Arquivo Base64
Listar Tags
Vincular Tag
Criar Tag
Listar Kanbans
Vincular Kanban
Listar Carteiras
Vincular Carteira
Agendamento:
- Listar Serviços
- Listar Usuários Disponíveis
- Listar Horários Disponíveis
- Criar Agendamento
- Cancelar Agendamento
- Gerar Link do Calendário (.ics)

Instalação

Via interface do n8n

Vá para Configurações > Community Nodes
Digite n8n-nodes-digitalsac na caixa de pesquisa
Clique em Instalar

Via linha de comando

npm install -g n8n-nodes-digitalsac

Ou se você estiver usando o n8n com um diretório específico:

cd ~/.n8n
npm install n8n-nodes-digitalsac

✨ Novas Funcionalidades (v0.5.1)

🔘 Enviar Botões Interativos

Envie mensagens com botões clicáveis:

Resposta Rápida: Botão que responde instantaneamente
URL: Botão que abre links
Copiar: Botão que copia texto
Ligar: Botão que inicia chamada

📋 Enviar Listas

Crie menus organizados com:

Múltiplas seções
Opções clicáveis
Descrições detalhadas

🖼️ Enviar Mídia com Caption

Envie arquivos com legendas personalizadas:

Upload direto de arquivos
Caption obrigatório
Suporte a imagens, PDFs, vídeos

📁 Enviar Base64

Envie arquivos via base64:

Sem necessidade de upload
Caption opcional
Ideal para integração com APIs

Autenticação

Configure as credenciais Digitalsac com a URL base e seu Bearer Token:

Vá para Credenciais > Criar Nova Credencial
Selecione Izing Pro Digitalsac API
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

Selecione a operação Validar WhatsApp
No campo Parâmetro, insira o número de telefone a ser validado

Validar CPF

Selecione a operação Validar CPF
No campo Parâmetro, insira o CPF a ser validado

Validar Data

Selecione a operação Validar Data
No campo Dados (JSON), insira os dados no formato:

{
  "data": "string com a data a ser validada"
}

Listar Filas/Atendentes

Selecione a operação Listar Filas ou Listar Atendentes
Não é necessário configurar parâmetros adicionais

Transferir para Fila

Selecione a operação Transferir para Fila
No campo Dados (JSON), insira os dados no formato:

{
  "ticketId": 0,
  "queueId": 0
}

Onde:

ticketId: ID do ticket a ser transferido
queueId: ID da fila de destino

Transferir para Atendente

Selecione a operação Transferir para Atendente
No campo Dados (JSON), insira os dados no formato:

{
  "ticketId": 0,
  "userId": 0
}

Onde:

ticketId: ID do ticket a ser transferido
userId: ID do atendente de destino

Fechar Ticket

Selecione a operação Fechar Ticket
No campo Dados (JSON), insira os dados no formato:

{
  "ticketId": 0
}

Onde:

ticketId: ID do ticket a ser fechado

Enviar Mensagem de Texto

Selecione a operação Enviar Mensagem
No campo Parâmetro, insira o UUID da conexão (ex: 999ab3a2-9f1f-4ffb-969a-bfb72234ece1)
No campo Corpo da Mensagem, insira o texto da mensagem
No campo Número de Telefone, insira o número no formato DDI+DDD+Número (ex: 5511999999999)
No campo Chave Externa, insira um identificador único opcional

Enviar Arquivo

Conecte um nó que forneça dados binários (ex: HTTP Request, Read Binary File, Google Drive)
Conecte ao nó Digitalsac
Selecione a operação Enviar Mensagem
No campo Parâmetro, insira o UUID da conexão
Preencha os demais campos normalmente
O nó detectará automaticamente o arquivo binário e enviará via FormData

Nota: O nó detecta automaticamente se há dados binários conectados e escolhe o método correto:

Sem arquivo: Envia como JSON (texto)
Com arquivo: Envia como FormData (arquivo + texto)

🔘 Enviar Botões Interativos

Selecione a operação Enviar Botões
No campo Parâmetro, insira o UUID da conexão
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"
No campo Botões (JSON), configure os botões:

[
  {
    "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

Selecione a operação Enviar Lista
No campo Parâmetro, insira o UUID da conexão
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"
No campo Seções (JSON), configure as seções:

[
  {
    "title": "🛍️ Produtos",
    "lines": [
      {
        "title": "Smartphone Premium",
        "description": "iPhone 15 Pro Max 256GB",
        "rowId": 1
      },
      {
        "title": "Notebook Gamer",
        "description": "Dell Alienware com RTX 4090",
        "rowId": 2
      }
    ]
  },
  {
    "title": "🛠️ Serviços",
    "lines": [
      {
        "title": "Suporte Técnico",
        "description": "Assistência técnica especializada",
        "rowId": 3
      },
      {
        "title": "Consultoria",
        "description": "Consultoria personalizada",
        "rowId": 4
      }
    ]
  },
  {
    "title": "📞 Contato",
    "lines": [
      {
        "title": "Falar com Vendedor",
        "description": "Atendimento comercial",
        "rowId": 5
      }
    ]
  }
]

🖼️ Enviar Mídia com Caption

Conecte um nó com arquivo (ex: HTTP Request, Read Binary File, Google Drive)
Conecte ao nó Digitalsac
Selecione a operação Enviar Mídia com Caption
No campo Parâmetro, insira o UUID da conexão
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

Selecione a operação Enviar Base64
No campo Parâmetro, insira o UUID da conexão
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:

{
  "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

Selecione a operação Listar Tags
Não é necessário configurar parâmetros adicionais

Vincular Tag

Selecione a operação Vincular Tag
No campo Dados (JSON), insira os dados no formato:

{
  "ticketId": 123,
  "tagId": 456
}

Onde:

ticketId: ID do ticket
tagId: ID da tag a ser vinculada

Criar Tag

Selecione a operação Criar Tag
No campo Nome da Tag, insira o nome da tag
No campo Cor da Tag, insira a cor em formato hexadecimal (ex: #FF5733, #2196F3, #4CAF50)

Listar Kanbans

Selecione a operação Listar Kanbans
No campo User ID, insira o ID do usuário

Vincular Kanban

Selecione a operação Vincular Kanban
No campo Dados (JSON), insira os dados no formato:

{
  "ticketId": 123,
  "kanbanId": 456,
  "userId": 789
}

Onde:

ticketId: ID do ticket
kanbanId: ID do kanban a ser vinculado
userId: ID do usuário

Listar Carteiras

Selecione a operação Listar Carteiras
Não é necessário configurar parâmetros adicionais

Vincular Carteira

Selecione a operação Vincular Carteira
No campo Dados (JSON), insira os dados no formato:

{
  "ticketId": 123,
  "userId": 456
}

Onde:

ticketId: ID do ticket
userId: ID do usuário da carteira

Exemplos de Respostas da API

Transferir para Fila

Resposta de sucesso:

{
  "status": 0
}

Transferir para Atendente

Resposta de sucesso:

{
  "status": 0
}

Fechar Ticket

Resposta de sucesso:

"string"

Validar Data

Resposta de sucesso:

{
  "status": 0
}

Criar Tag

Resposta de sucesso (tag criada):

{
  "status": 1,
  "tagId": 456
}

Resposta quando tag já existe:

{
  "status": 2
}

Resposta de erro:

{
  "status": 0
}

Vincular Tag/Kanban/Carteira

Resposta de sucesso:

{
  "status": 0
}

Exemplo de Fluxo

Enviar PDF para um contato

Adicione um nó Read Binary File
- Configure para ler um arquivo PDF
Conecte ao nó Digitalsac
- Operação: Enviar Mensagem
- Parâmetro: 999ab3a2-9f1f-4ffb-969a-bfb72234ece1 (seu UUID de conexão)
- Corpo da Mensagem: Segue o PDF solicitado
- Número de Telefone: 5511999999999
- Chave Externa: pdf_documento_123

Transferir ticket para uma fila específica

Adicione um nó Digitalsac
- Operação: Transferir para Fila
- Dados (JSON):
```
{
  "ticketId": 123,
  "queueId": 5
}
```

Transferir ticket para um atendente específico

Adicione um nó Digitalsac
- Operação: Transferir para Atendente
- Dados (JSON):
```
{
  "ticketId": 123,
  "userId": 10
}
```

Criar uma tag e vincular a um ticket

Adicione um nó Digitalsac
- Operação: Criar Tag
- Nome da Tag: Suporte Técnico
- Cor da Tag: #2196F3
Conecte a outro nó Digitalsac
- Operação: Vincular Tag
- Dados (JSON):
```
{
  "ticketId": 123,
  "tagId": "{{$json.tagId}}"
}
```

Listar kanbans de um usuário e vincular a um ticket

Adicione um nó Digitalsac
- Operação: Listar Kanbans
- User ID: 10
Conecte a outro nó Digitalsac
- Operação: Vincular Kanban
- Dados (JSON):
```
{
  "ticketId": 123,
  "kanbanId": 5,
  "userId": 10
}
```

Vincular carteira a um ticket

Adicione um nó Digitalsac
- Operação: Vincular Carteira
- Dados (JSON):
```
{
  "ticketId": 123,
  "userId": 15
}
```

Gerar link de calendário para um agendamento

Adicione um nó Digitalsac
- Operação: Gerar Link do Calendário (.ics)
- ID do Agendamento: 123
O retorno pode ser usado para:
- Enviar o link direto para o cliente
- Fazer download automático do arquivo .ics
- Integrar com outros sistemas de calendário

Funcionalidades de Agendamento

Listar Serviços

Lista todos os serviços disponíveis para agendamento.

Selecione a operação Listar Serviços
(Opcional) No campo ID do Usuário, insira o ID do usuário para filtrar apenas os serviços que ele atende

Retorno exemplo:

{
  "servicos": "*1* - Consulta (30min - R$ 100,00)\n*2* - Retorno (15min - R$ 50,00)"
}

Listar Usuários Disponíveis

Lista os usuários/atendentes disponíveis para um serviço em uma data específica.

Selecione a operação Listar Usuários Disponíveis
Preencha:
- ID do Serviço: ID do serviço desejado
- Data: Data no formato YYYY-MM-DD (ex: 2025-08-07)
- Horário (opcional): Horário específico no formato HH:mm (ex: 09:00)

Retorno exemplo:

{
  "usuarios": "*28* - João Silva\n*29* - Maria Santos"
}

Listar Horários Disponíveis

Lista os horários disponíveis para um serviço e usuário em uma data específica.

Selecione a operação Listar Horários Disponíveis
Preencha:
- ID do Serviço: ID do serviço desejado
- ID do Usuário: ID do atendente/usuário
- Data: Data no formato YYYY-MM-DD

Retorno exemplo:

{
  "horarios": "*1* - 09:00\n*2* - 09:30\n*3* - 10:00\n*4* - 10:30"
}

Criar Agendamento

Cria um novo agendamento no sistema.

Selecione a operação Criar Agendamento
Preencha:
- ID do Serviço: ID do serviço
- ID do Usuário: ID do atendente/usuário
- Data: Data do agendamento (YYYY-MM-DD)
- Horário: Horário do agendamento (HH:mm)
- Nome do Contato: Nome do cliente
- Telefone do Contato: Telefone do cliente (formato: 5511999999999)
- Observações (opcional): Notas sobre o agendamento
- ID da Conexão WhatsApp (opcional): ID da conexão WhatsApp (usa primeira disponível se não informado)
- Mensagem Personalizada (opcional): Mensagem personalizada do agendamento
- Lembretes (minutos): Lembretes em minutos antes do agendamento (separados por vírgula, ex: 60,240,1440)
- Duração do Intervalo (minutos): Duração do intervalo em minutos (padrão: 30)
- Fechar Ticket: Se deve fechar o ticket após criar agendamento

Observações importantes:

Se o contato não existir no sistema, ele será criado automaticamente
Se não informar conexão WhatsApp, será usada a primeira disponível
Os lembretes são em minutos (60 = 1 hora, 240 = 4 horas, 1440 = 1 dia)

Retorno exemplo:

{
  "status": 1,
  "mensagem": "Agendamento criado com sucesso",
  "scheduleId": 123,
  "contactId": 456,
  "whatsappId": 789
}

Cancelar Agendamento

Cancela um agendamento existente.

Selecione a operação Cancelar Agendamento
Preencha:
- ID do Agendamento: ID do agendamento a ser cancelado

Retorno exemplo:

{
  "status": 0,
  "mensagem": "Agendamento cancelado com sucesso"
}

Gerar Link do Calendário (.ics)

Gera um link para download do arquivo .ics (calendário) de um agendamento específico.

Selecione a operação Gerar Link do Calendário (.ics)
Preencha:
- ID do Agendamento: ID do agendamento para gerar o link do calendário

Retorno exemplo:

{
  "status": 1,
  "link": "https://seudominio.com/schedules/123/ics",
  "scheduleId": 123,
  "info": {
    "cliente": "João Silva",
    "servico": "Consulta Médica",
    "data": "2025-01-15T14:30:00.000Z",
    "funcionario": "Dr. Pedro Santos"
  }
}

Uso do link:

O link gerado pode ser usado diretamente para download do arquivo .ics
O arquivo .ics contém todas as informações do agendamento
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:

Enviar Botões → Menu inicial com opções
Enviar Lista → Catálogo de produtos/serviços
Enviar Mídia → Imagens dos produtos
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.

digitalsac

Package Information

Available Nodes

Documentation

n8n-nodes-digitalsac

Funcionalidades

Instalação

Via interface do n8n

Via linha de comando

✨ Novas Funcionalidades (v0.5.1)

🔘 Enviar Botões Interativos

📋 Enviar Listas

🖼️ Enviar Mídia com Caption

📁 Enviar Base64

Autenticação

Como Usar

Validar WhatsApp

Validar CPF

Validar Data

Listar Filas/Atendentes

Transferir para Fila

Transferir para Atendente

Fechar Ticket

Enviar Mensagem de Texto

Enviar Arquivo

🔘 Enviar Botões Interativos

📋 Enviar Lista

🖼️ Enviar Mídia com Caption

📁 Enviar Base64

Listar Tags

Vincular Tag

Criar Tag

Listar Kanbans

Vincular Kanban

Listar Carteiras

Vincular Carteira

Exemplos de Respostas da API

Transferir para Fila

Transferir para Atendente

Fechar Ticket

Validar Data

Criar Tag

Vincular Tag/Kanban/Carteira

Exemplo de Fluxo

Enviar PDF para um contato

Transferir ticket para uma fila específica

Transferir ticket para um atendente específico

Criar uma tag e vincular a um ticket

Listar kanbans de um usuário e vincular a um ticket

Vincular carteira a um ticket

Gerar link de calendário para um agendamento

Funcionalidades de Agendamento

Listar Serviços

Listar Usuários Disponíveis

Listar Horários Disponíveis

Criar Agendamento

Cancelar Agendamento

Gerar Link do Calendário (.ics)

💡 Casos de Uso Práticos

🤖 Bot de Atendimento Interativo

🛒 E-commerce Automation

📊 Relatórios Automatizados

🎯 Marketing Campaigns

🔄 Workflow Exemplo Completo

Suporte

Discussion