digitalsac

Izing Pro Digitalsac - Compatible with n8n v2.x

Package Information

Downloads: 65 weekly / 1,158 monthly
Latest Version: 1.1.3
Author: Digitalsac.io

Documentation

n8n-nodes-digitalsac

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

✅ Versão para n8n v2.x

Esta é a versão 1.1.3, compatível com n8n v2.x

A linha para n8n v1.x foi descontinuada e mantida apenas como legado.

🆕 O que tem de novo nesta versão (1.1.3)

  • ✅ Nova operação Enviar Carousel no node Digitalsac
  • ✅ Endpoint suportado: POST /v1/api/external/{uuid}/send-carousel
  • ✅ Documentação de uso atualizada com exemplo de cards (JSON)
  • ✅ Nova operação Próximo Atendente da Fila (next-assignee)
  • ✅ Nova operação Transferir para Próximo Atendente (transfer-next-assignee)
  • ✅ Operação Vincular Kanban atualizada para uso documentado do endpoint POST /typebot/vincular_kanban_v2
  • ✅ Exemplo completo com campos opcionais do Kanban V2 no README

Funcionalidades

  • Validar número de WhatsApp
  • Validar CPF
  • Validar Data
  • Listar Filas
  • Listar Atendentes
  • Transferir para Fila
  • Transferir para Atendente
  • Próximo Atendente da Fila (next-assignee)
  • Transferir para Próximo Atendente (transfer-next-assignee)
  • Fechar Ticket
  • Enviar Mensagem (texto e arquivos)
  • Enviar Botões Interativos
  • Enviar Listas
  • Enviar Carousel
  • 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)
  • Templates WABA:
    • Listar Templates WABA
    • Enviar Template WABA

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

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.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:

  • 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:

  1. Vá para Credenciais > Criar Nova Credencial
  2. Selecione Izing Pro Digitalsac API
  3. Preencha:

Licença para endpoints de distribuição

As operações Próximo Atendente da Fila e Transferir para Próximo Atendente usam os endpoints:

  • POST /v1/api/external/:apiId/next-assignee
  • POST /v1/api/external/:apiId/transfer-next-assignee

Esses endpoints funcionam apenas em planos Izing Cloud 4 core ou superiores:

  • CLOUD4CORE
  • CLOUD6CORE
  • CLOUD8CORE

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:
{
  "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:
{
  "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:
{
  "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:
{
  "ticketId": 0
}

Onde:

  • ticketId: ID do ticket a ser fechado

Próximo Atendente da Fila (next-assignee)

  1. Selecione a operação Próximo Atendente da Fila
  2. No campo Parâmetro, informe o UUID da conexão (apiId)
  3. No campo Dados (JSON), use:
{
  "queueId": 3,
  "ticketId": 1201,
  "method": "S",
  "allowOffline": false
}

Endpoint chamado pelo node: POST /v1/api/external/:apiId/next-assignee

Métodos aceitos em method:

  • R (Random)
  • B (Balanced)
  • S (Sequential)
  • L (Sticky com fallback para Balanced)

Resposta de sucesso:

{
  "queueId": 3,
  "method": "S",
  "nextUser": {
    "id": 17,
    "name": "Maria"
  }
}

Resposta sem usuário elegível:

{
  "queueId": 3,
  "method": "S",
  "nextUser": null
}

Transferir para Próximo Atendente (transfer-next-assignee)

  1. Selecione a operação Transferir para Próximo Atendente
  2. No campo Parâmetro, informe o UUID da conexão (apiId)
  3. No campo Dados (JSON), use:
{
  "queueId": 3,
  "ticketId": 1201,
  "method": "S",
  "allowOffline": false
}

Endpoint chamado pelo node: POST /v1/api/external/:apiId/transfer-next-assignee

Resposta de sucesso:

{
  "ticketId": 1201,
  "queueId": 3,
  "method": "S",
  "transferredTo": {
    "id": 17,
    "name": "Maria"
  }
}

Resposta sem usuário elegível:

{
  "ticketId": 1201,
  "queueId": 3,
  "method": "S",
  "transferredTo": null
}

Enviar Mensagem de Texto

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

Enviar Arquivo

  1. Conecte um nó que forneça dados binários (ex: HTTP Request, Read Binary File, Google Drive)
  2. Conecte ao nó Digitalsac
  3. Selecione a operação Enviar Mensagem
  4. No campo Parâmetro, insira o UUID da conexão
  5. Preencha os demais campos normalmente
  6. 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

  1. Selecione a operação Enviar Botões
  2. No campo Parâmetro, insira o UUID da conexão
  3. 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"
  4. 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

  1. Selecione a operação Enviar Lista
  2. No campo Parâmetro, insira o UUID da conexão
  3. 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"
  4. 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

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

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

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

Vincular Tag

  1. Selecione a operação Vincular Tag
  2. 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

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

Listar Kanbans

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

Vincular Kanban

  1. Selecione a operação Vincular Kanban
  2. Esta operação usa o endpoint POST /typebot/vincular_kanban_v2
  3. No campo Dados (JSON), você pode usar o payload mínimo:
{
  "ticketId": 123,
  "kanbanId": 456,
  "userId": 789
}
  1. Exemplo completo com campos opcionais:
{
  "ticketId": 123,
  "kanbanId": 456,
  "userId": 789,
  "value": 500.5,
  "status": "novo",
  "kanbanCreatedAt": "2026-03-09T10:00:00Z",
  "shortDesc": "Lead inbound",
  "probability": 70,
  "funnelStatus": "open",
  "expectedCloseAt": "2026-04-01T12:00:00Z",
  "assignedUserId": 12
}

Onde os obrigatórios são:

  • ticketId: ID do ticket
  • kanbanId: ID do kanban a ser vinculado
  • userId: ID do usuário
  1. Campos opcionais:
  • value, status, kanbanCreatedAt, shortDesc, probability, funnelStatus, expectedCloseAt, assignedUserId

Listar Carteiras

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

Vincular Carteira

  1. Selecione a operação Vincular Carteira
  2. 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

  1. Adicione um nó Read Binary File
    • Configure para ler um arquivo PDF
  2. 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

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

Transferir ticket para um atendente específico

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

Criar uma tag e vincular a um ticket

  1. Adicione um nó Digitalsac
    • Operação: Criar Tag
    • Nome da Tag: Suporte Técnico
    • Cor da Tag: #2196F3
  2. 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

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

Vincular carteira a um ticket

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

Gerar link de calendário para um agendamento

  1. Adicione um nó Digitalsac
    • Operação: Gerar Link do Calendário (.ics)
    • ID do Agendamento: 123
  2. 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.

  1. Selecione a operação Listar Serviços
  2. (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.

  1. Selecione a operação Listar Usuários Disponíveis
  2. 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.

  1. Selecione a operação Listar Horários Disponíveis
  2. 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.

  1. Selecione a operação Criar Agendamento
  2. 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.

  1. Selecione a operação Cancelar Agendamento
  2. 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.

  1. Selecione a operação Gerar Link do Calendário (.ics)
  2. 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

📱 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:

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

{
  "nome_cliente": "João Silva",
  "numero_pedido": "12345",
  "data_entrega": "15/01/2025"
}

Retorno exemplo:

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

Combine as novas operações para criar um fluxo completo:

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

📱 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.

Discussion