n8n-nodes-alphasac

Node community do n8n para a API de Integração do AlphaSac — envie mensagens, transfira tickets, aplique etiquetas e feche atendimentos direto dos seus fluxos.

Instalação

n8n self-hosted (recomendado): Configurações → Community Nodes → Instalar → n8n-nodes-alphasac.

Ou via npm no servidor:

npm install n8n-nodes-alphasac

Credencial

Crie uma credencial AlphaSac API com:

| Campo | Descrição | |---|---| | Base URL | URL da API — fornecida pela AlphaSac | | Bearer Token | Gerado no AlphaSac em Configurações → API de Integração | | External Key | Opcional — só se você configurou uma externalKey na API |

Operações

Mensagem e Ticket identificam o atendimento pelo Ticket ID (número do ticket). Estoque, Bot e Instagram operam no cliente inteiro e não pedem ticket.

Mensagem

• Enviar Texto
• Enviar Imagem / Áudio / Documento (por URL)
• Enviar Botões — até 3 botões do tipo resposta, copiar, ligar ou link, com imagem opcional no topo
• Enviar Lista (seções em JSON)
• Enviar Carrossel (cards em JSON)
• Enviar Template (WABA) — só canais WhatsApp Oficial; nome do template aprovado + variáveis

Ticket

• Transferir para Setor — por nome (ex.: Suporte) ou ID
• Transferir para Agente — por e-mail ou ID
• Aplicar Etiqueta — por nome ou ID (com opção de remover)
• Fechar Ticket
• Adicionar Nota — nota interna no atendimento; o cliente não vê. Serve para o agente de IA deixar o contexto do que já apurou antes de passar para um humano.

Estoque (exige o plugin contratado)

• Consultar Estoque — filtra por busca/categoria, com opção de só o que tem saldo
• Registrar Venda — lança a venda e dá baixa automática; pode vincular a um ticket

Bot (não usa ticket)

• Listar Nós com Imagem — descobre bots e nós (com nome e ID) sem abrir o editor
• Trocar Imagem de Nó — troca ou remove a arte de um nó (campanha, feriado). A arte nova vira um arquivo novo no storage: CDN e WhatsApp nunca servem a imagem velha por engano.

Instagram (não usa ticket)

• Agendar Post — marca uma publicação de Feed (imagem ou carrossel de até 10) ou Story para a data escolhida. Aceita URL pública ou base64.

Três coisas que valem saber antes de montar o fluxo:

1. A imagem é baixada na hora do agendamento. URL de imagem gerada por IA costuma expirar em cerca de uma hora; se o post é para a semana que vem, o link já estaria morto na publicação. O AlphaSac guarda uma cópia e publica a partir dela.
2. Só JPEG, e dentro da proporção (4:5 a 1.91:1 no feed). A checagem é feita nos bytes do arquivo no momento do agendamento, com erro explicando o motivo — não na data marcada, quando ninguém mais está olhando. Para converter, use o nó Edit Image do próprio n8n.
3. Sem "Publicar Em", o post sai dentro de um minuto. Ligue Apenas Validar (Dry Run) enquanto monta o fluxo: ele confere tudo e não agenda nada. Publicação do Instagram não pode ser apagada pela API.

Reels e vídeo não passam pelo node — agende pela tela Agendamentos → Posts do Instagram no AlphaSac.

Rastreio da execução

O node envia o ID da execução junto de cada chamada (opção Enviar ID da Execução, ligada por padrão). No AlphaSac, o administrador vê um ? ao lado do ícone do bot na conversa e, clicando, cai direto na execução do n8n que gerou aquela resposta.

Para o link funcionar, preencha a URL das execuções do n8n em Configurações → API de Integração no AlphaSac — ex.: https://seu-n8n.com/workflow/ID-DO-WORKFLOW/executions/.

Observações

• Ao transferir para setor/agente ou fechar, o AlphaSac para de encaminhar as mensagens daquele atendimento para o webhook (o humano assumiu).
• Setor, agente e etiqueta aceitam nome ou ID (uuid) — não precisa saber os IDs.
• Chamando a API na mão (HTTP Request), o número do ticket é aceito como ticket_number, ticketNumber, ticketId, ticket ou numero — com ou sem #. A conversa, como conversation_id ou conversationId.

Licença

MIT