Saltar para o conteúdo principal

​
Integrações Customizadas

Construa integrações sob medida para conectar o SalesOS aos seus sistemas internos usando a API REST e webhooks.

​
Abordagens de integração

API REST

Faça requisições diretas à API para ler e escrever dados no SalesOS.

Webhooks

Receba eventos em tempo real e reaja automaticamente.

SalesOS Connect

Use o n8n como camada de integração visual sem código.

​
Guia de implementação

1

Defina o escopo

Identifique quais dados precisam ser sincronizados e em qual direção (SalesOS para seu sistema, vice-versa, ou ambos).
2

Obtenha credenciais

Gere um Client ID e Secret em Configurações > API > Credenciais.
3

Implemente a autenticação

Configure o fluxo de autenticação OAuth2 para obter tokens JWT.
4

Desenvolva a integração

Implemente as chamadas à API e/ou configure webhooks para eventos.
5

Teste em ambiente seguro

Valide a integração completamente antes de ativá-la em produção.
6

Monitore

Acompanhe logs de webhook e métricas da API para garantir funcionamento correto.

​
Cenários comuns

Seu site captura leads em formulários e envia para o SalesOS via POST /v1/leads. Ideal para landing pages, chatbots e formulários de contato.
Exporte dados do CRM antigo para o SalesOS via API em lote, ou mantenha ambos sincronizados durante o período de migração.
Consuma dados de leads, deals e métricas via API para alimentar dashboards em ferramentas como Power BI, Metabase ou Grafana.
Configure webhooks para enviar notificações de eventos (deal ganho, novo lead) para Slack, Microsoft Teams ou Discord.
Ao fechar um deal, envie os dados para seu sistema financeiro via webhook ou chamada API para gerar pedidos, contratos ou faturas.

​
Boas práticas

  • Armazene credenciais em variáveis de ambiente, nunca no código
  • Valide assinaturas de webhooks antes de processar
  • Use HTTPS em todos os endpoints
  • Implemente rate limiting no seu lado
Para integrações que não exigem código, considere usar o SalesOS Connect (n8n) com sua interface visual de arrastar e soltar.
Respeite o rate limit da API (100 requisições/minuto). Integrações que excedem consistentemente o limite podem ter o acesso temporariamente bloqueado.

​
Próximos passos

Autenticação

Configure a autenticação da sua integração.

Webhooks

Receba eventos em tempo real.