Integração do Workspace369 com n8n

A integração n8n do Workspace369 funciona hoje, no n8n Cloud ou em seu próprio servidor. Uma fatura paga, uma proposta aceita ou um novo lead inicia um fluxo de trabalho através do nó Webhook, e o nó HTTP Request cria ou lê clientes, faturas, tarefas e projetos através da API do Workspace369.

Execução de fluxo de trabalho
invoice.paidPOST your-n8n.example/webhook/… → 200
Requisição HTTPGET mcp.workspace369.com/v1/invoices/{id} → 200
Requisição HTTPPOST mcp.workspace369.com/v1/tasks → 200

Eventos do Workspace369 entram, chamadas de API saem

Registros conectados

Mantenha o contexto do cliente anexado

Os fluxos de trabalho do n8n permanecem vinculados aos clientes, requisições, projetos, faturas, pagamentos, arquivos e atividades que sua equipe já gerencia no Workspace369.

Adequação operacional

Apoie o trabalho já em andamento

Use a integração juntamente com vendas, agendamento, entrega, comunicação, faturamento, relatórios e contabilidade em vez de tratá-la como uma ferramenta separada.

Visibilidade da equipe

Dê a cada função a mesma imagem

Ajude proprietários, operadores, equipes de finanças, suporte e entrega a entender o que aconteceu sem juntar registros de sistemas desconectados.

Como funciona

Como o n8n funciona com o Workspace369

  1. 01

    Workspace369 envia o gatilho

    Em Configurações → Webhooks, você aponta eventos para a URL de produção do seu nó Webhook do n8n. Cada evento chega como JSON assinado com o id do registro.

  2. 02

    n8n executa seu fluxo de trabalho

    Os nós usam os campos do evento, ou um nó HTTP Request busca primeiro a fatura, proposta ou cliente completo da API do Workspace369.

  3. 03

    Nós HTTP Request chamam a API

    O nó HTTP Request chama a API do Workspace369 via HTTPS simples com seu token de acesso pessoal armazenado como uma credencial n8n.

Gatilhos

Os 21 eventos que podem iniciar um fluxo de trabalho

Faturas

invoice.created, invoice.paid (movido para Paid) e invoice.status_changed.

Propostas

proposta.enviada, proposta.aceita e proposta.recusada.

Contratos

contract.sent, contract.recipient_completed, contract.completed, contract.declined, contract.voided e contract.expired.

Leads

lead.created, lead.converted e lead.archived, para requisições recebidas.

Tempo

time_entry.created, time_entry.updated, time_entry.deleted, timesheet.submitted, timesheet.approved e timesheet.rejected.

Ações

O que um fluxo de trabalho pode fazer no Workspace369

Clientes

Pesquise, leia, crie e atualize: GET ou POST /v1/clients, GET ou PATCH /v1/clients/{id}.

Projetos e tarefas

POST /v1/projects e POST /v1/tasks os criam; PATCH os atualiza.

Propostas, faturas e contratos

Crie rascunhos com POST /v1/proposals, /v1/invoices ou /v1/contracts. Uma chamada de envio espera que uma pessoa aprove no aplicativo, a menos que o proprietário do token tenha ativado "enviar sem perguntar".

Calendário e requisições

POST /v1/calendar/events agenda um evento; PATCH /v1/requests/{id} atualiza o status de uma requisição.

Qualquer outra ferramenta

POST /v1/tools/{name} executa qualquer ferramenta na especificação OpenAPI por nome, como payments_record ou time_entries_create.

Nó nativo

Em desenvolvimento. Até lá, os nós Webhook e HTTP Request são a forma de conectar.

Configuração

Configurando o n8n

  1. 01

    Adicionar um nó Webhook no n8n

    Inicie um fluxo de trabalho com o nó Webhook, defina o método como POST e copie a URL de produção. Ative a opção Raw Body se você for verificar assinaturas.

  2. 02

    Adicionar o webhook no Workspace369

    Em Configurações → Webhooks, escolha Novo webhook, cole a URL de produção do n8n como endpoint, selecione os eventos e salve. Copie o segredo de assinatura; ele é mostrado uma vez. Publique o fluxo de trabalho para que a URL de produção esteja ativa.

  3. 03

    Criar um token de acesso pessoal

    Em Configurações → Conexões de IA, crie um token com apenas os escopos que o fluxo de trabalho precisa e salve-o como uma credencial de cabeçalho no n8n. Um administrador deve ter ativado as conexões de IA para o espaço de trabalho.

  4. 04

    Chamar a API a partir de um nó HTTP Request

    Adicione um nó HTTP Request. Defina o método e uma URL como https://mcp.workspace369.com/v1/tasks, envie Authorization: Bearer seguido do seu token e um corpo JSON com os campos.

Adequação operacional

A conexão só é útil quando a equipe pode ver o contexto.

O Workspace369 mantém a integração próxima do registo do cliente, para que proprietários, operadores, finanças, suporte e entrega não tenham que reconstruir a mesma história em ferramentas separadas.

Conectar o sistema

Traga o fluxo de trabalho externo ao lado dos registros do Workspace369 sem alterar a forma como sua equipe nomeia clientes, trabalhos, faturas e projetos.

Mantenha o contexto visível

Mostrar o status, evento, pagamento, mensagem ou registro relevante onde a equipe já trabalha.

Aja a partir do espaço de trabalho

Use o contexto conectado para acompanhar, faturar, agendar, automatizar, relatar e manter o cliente em movimento.

Na prática

Para que as equipes usam o n8n

Executando suas próprias automações em seu próprio servidor

n8n auto-hospedado executa o fluxo de trabalho em um servidor que você controla, enquanto o Workspace369 envia eventos para ele e recebe chamadas de API dele.

Criação de registros do Workspace369 a partir de outros sistemas

Um formulário, banco de dados ou ferramenta de agendamento no n8n pode criar um cliente, projeto, tarefa ou evento de calendário no Workspace369 com um nó HTTP Request.

Verificando cada evento antes de agir

Um nó Code pode verificar a assinatura HMAC-SHA256 de cada evento, para que o fluxo só seja executado para requisições que o Workspace369 realmente enviou.

FAQ

Perguntas sobre n8n

Como funciona a integração do Workspace369 com o n8n?
Ele usa os nós Webhook e HTTP Request integrados do n8n, no n8n Cloud ou auto-hospedado. Os webhooks do Workspace369 enviam 21 eventos sobre faturas, propostas, contratos, leads e tempo para um nó Webhook, e os nós HTTP Request chamam a API do Workspace369 Builder via HTTPS com um token de acesso pessoal. Não há eventos para clientes, projetos, tarefas ou reservas; um fluxo de trabalho os lê através da API. O n8n auto-hospedado funciona se seu URL de Webhook for um endereço https:// público na porta padrão.
Qual é a diferença entre gatilhos e ações aqui?
Os gatilhos vêm do Workspace369: um dos 21 eventos de webhook inicia o fluxo de trabalho. As ações vão na direção oposta: um nó HTTP Request cria, atualiza ou lê clientes, projetos, tarefas, faturas, propostas, contratos e eventos de calendário através da API. O envio de uma proposta, contrato ou fatura retorna 202 e aguarda a aprovação de uma pessoa no aplicativo, a menos que o proprietário do token tenha ativado "enviar sem perguntar".
Qual plano do Workspace369 eu preciso?
Specialist (US$ 149 por mês, 10 assentos) e superior. Gatilhos de webhook e a API do Builder precisam do Specialist. No Cadet e Voyager, um fluxo de trabalho ainda pode chamar as mesmas ferramentas através de ferramentas MCP/call depois que um administrador ativar as conexões de IA, mas não pode receber gatilhos de webhook.
Os fluxos de trabalho do n8n usam uso de IA?
Cada ação que Zapier, Make ou n8n executa através da API ou MCP usa um pouco do uso de IA do seu espaço de trabalho; leituras usam menos que escritas e envios. Chamadas falhadas e gatilhos de webhook não usam nada.
Como verifico a assinatura do webhook no n8n?
Ative a opção Raw Body do nó Webhook e adicione um nó Code. Ele calcula o HMAC-SHA256 hexadecimal do corpo bruto seguido pelo cabeçalho X-Webhook-Timestamp, com chave usando seu segredo de assinatura whsec_ completo, e o compara com X-Webhook-Signature. O nó Webhook não o verifica para você.
Existe um nó do Workspace369 para n8n?
Ainda não. Um nó nativo do n8n está em desenvolvimento. Até que esteja pronto, os nós Webhook e HTTP Request integrados conectam os dois como esta página descreve.

Veja o Workspace369 atual no aplicativo real.

Mapeie seus clientes, solicitações, comunicação, projetos, faturamento, pagamentos, IA, automações, contabilidade e relatórios em um único espaço de trabalho calmo.

Começar grátis Falar com vendas

Teste grátis de 14 dias. Cartão necessário. Após o teste: a partir de US$ 29/mês. Renova automaticamente todo mês até você cancelar. Cancele a qualquer momento em Configurações → Cobrança.

20+módulos conectados
24/7acesso do cliente
Umvisão operacional