n8n-nodes-pressticket

Este pacote contém um nó personalizado para n8n que permite integração com a API do Press Ticket®, uma plataforma de atendimento via WhatsApp.

Instalação

Instalação Global (Recomendado para n8n Self-Hosted)

npm install -g @rtenorioh/n8n-nodes-pressticket

Instalação Local (Para desenvolvimento)

1. Clone este repositório
2. Navegue até o diretório do projeto
3. Execute os comandos:

npm install
npm run build

Configuração

Credenciais

Para utilizar o nó Press Ticket®, você precisa configurar as credenciais de acesso à API:

1. No n8n, vá para Configurações > Credenciais > Adicionar nova credencial
2. Selecione o tipo "Press Ticket® API"
3. Preencha os campos:
   • API URL: URL base da API (ex: https://apiback.pressticket.com.br)
   • API Token: Token de acesso à API do Press Ticket®

Permissões Necessárias

O token de API deve ter as seguintes permissões, dependendo das operações que você deseja realizar:

• create:messages: Para enviar mensagens de texto e mídia
• read:contacts: Para listar e obter contatos
• read:tickets: Para listar e obter tickets
• create:tickets: Para criar tickets
• update:tickets: Para atualizar tickets
• read:queue: Para listar setores

Recursos e Operações

Mensagem

Enviar Texto

Envia uma mensagem de texto para um número de WhatsApp.

Parâmetros:

• Número do WhatsApp: Número no formato internacional (ex: 5511999999999)
• ID do Usuário: ID do usuário que está enviando a mensagem
• ID do Setor: ID do setor
• ID da Conexão WhatsApp: ID da conexão do WhatsApp
• Texto da Mensagem: Conteúdo da mensagem a ser enviada

Enviar Mídia

Envia uma mensagem com mídia (imagem, vídeo, áudio ou documento) para um número de WhatsApp.

Parâmetros:

• Número do WhatsApp: Número no formato internacional (ex: 5511999999999)
• ID do Usuário: ID do usuário que está enviando a mensagem
• ID do Setor: ID do setor
• ID da Conexão WhatsApp: ID da conexão do WhatsApp
• Tipo de Mídia: Imagem, Vídeo, Áudio ou Documento
• Método de Entrada: Escolha entre URL ou Arquivo Binário
  • URL da Mídia: URL pública da mídia a ser enviada (quando o método for URL)
  • Propriedade Binária: Nome da propriedade que contém os dados do arquivo (quando o método for Arquivo Binário)
• Legenda: Texto que acompanha a mídia (opcional para imagem, vídeo e documento)

Contato

Listar

Lista todos os contatos cadastrados.

Obter

Obtém detalhes de um contato específico.

Parâmetros:

• ID do Contato: Identificador único do contato

Ticket

Listar

Lista todos os tickets.

Obter

Obtém detalhes de um ticket específico.

Parâmetros:

• ID do Ticket: Identificador único do ticket

Criar

Cria um novo ticket.

Parâmetros:

• ID do Contato: ID do contato para o qual o ticket será criado
• Status: Status do ticket (Aberto, Pendente ou Fechado)
• ID do Setor: ID do setor para o qual o ticket será atribuído (opcional)
• ID do Usuário: ID do usuário para o qual o ticket será atribuído (opcional)

Atualizar

Atualiza um ticket existente.

Parâmetros:

• ID do Ticket: Identificador único do ticket
• Status: Status do ticket (Aberto, Pendente ou Fechado)
• ID do Setor: ID do setor para o qual o ticket será atribuído (opcional)
• ID do Usuário: ID do usuário para o qual o ticket será atribuído (opcional)

Setor

Listar

Lista todos os setores cadastrados.

Exemplos de Uso

Envio de Mensagem de Texto

1. Adicione o nó "Press Ticket®" ao seu fluxo de trabalho
2. Selecione o recurso "Mensagem" e a operação "Enviar Texto"
3. Configure os parâmetros:
   • Número do WhatsApp: 5511999999999
   • ID do Usuário: 1
   • ID do Setor: 1
   • ID da Conexão WhatsApp: 1
   • Texto da Mensagem: "Olá, esta é uma mensagem de teste!"

Criação de Ticket

1. Adicione o nó "Press Ticket®" ao seu fluxo de trabalho
2. Selecione o recurso "Ticket" e a operação "Criar"
3. Configure os parâmetros:
   • ID do Contato: 1
   • Status: "open"
   • ID do Setor: 1
   • ID do Usuário: 1

Solução de Problemas

Erro 403 (Forbidden)

Se você receber um erro 403 com a mensagem "Invalid token", verifique:

1. Se o token de API está correto
2. Se o token possui as permissões necessárias para a operação que está tentando realizar
3. Se os IDs de usuário, setor e conexão WhatsApp estão corretos

Desenvolvimento

Estrutura do Projeto

n8n-nodes-pressticket/
├── credentials/
│   └── PressTicketApi.credentials.ts
├── nodes/
│   └── PressTicket/
│       ├── PressTicket.node.ts
│       └── pressTicket.svg
├── dist/
├── package.json
└── README.md

Compilação

Para compilar o projeto, execute:

npm run build

Publicação

Para publicar uma nova versão do pacote no npm:

npm version patch
npm run build
npm publish

Licença

MIT