Integrações

Conecte seu ecossistema ao SniperSell

O módulo de Integrações permite conectar o SniperSell às ferramentas que sua empresa já utiliza. Gmail, Google Calendar, ERPs como Omie, plataformas de automação (Zapier, Make, n8n) e qualquer sistema com API REST — tudo se comunica de forma bidirecional.

As integrações eliminam a necessidade de entrada duplicada de dados. Emails enviados pelo Gmail aparecem automaticamente no CRM, reuniões do Calendar ficam vinculadas a deals, e contratos do Omie sincronizam com o financeiro. Cada integração mantém um log completo de sincronização para auditoria e troubleshooting.

Para desenvolvedores e equipes técnicas, a API REST do SniperSell oferece acesso completo a todas as entidades da plataforma com autenticação OAuth2, documentação interativa e rate limiting inteligente.

Webhooks inbound e outbound permitem automações em tempo real: receba notificações quando um deal mudar de etapa, ou envie dados para sistemas externos quando um ticket for resolvido.

Integração Nativa

Conexões pré-construídas com configuração simplificada: Gmail, Google Calendar, Omie ERP. Basta autenticar e configurar as regras de sincronização. Não requer conhecimento técnico.

Webhook Inbound

Endpoint que recebe dados de sistemas externos. Exemplo: um formulário externo envia dados para o SniperSell, que cria automaticamente um lead no CRM.

Webhook Outbound

Notificação enviada pelo SniperSell quando um evento ocorre. Exemplo: ao fechar um deal, o sistema dispara um webhook para o ERP iniciar o faturamento.

Field Mapping

Mapeamento de campos entre o SniperSell e o sistema externo. Define qual campo do CRM corresponde a qual campo do ERP, garantindo que os dados sejam sincronizados corretamente.

Sync Log

Registro detalhado de cada operação de sincronização: data, direção, status (sucesso/erro), dados enviados e resposta recebida. Essencial para debugging e auditoria.

Configurando sua primeira integração

Pré-requisitos: Acesso de administrador na organização. Credenciais do serviço externo (conta Gmail, chave API do ERP, etc.).

1. Acesse Gerir → Integrações no menu lateral.
2. Escolha a integração desejada na lista de conectores disponíveis.
3. Clique em Conectar e siga o fluxo de autenticação (OAuth2 para Gmail/Calendar, API Key para ERPs).
4. Configure as regras de sincronização: direção (uni ou bidirecional), frequência, filtros.
5. Mapeie os campos entre os sistemas (field mapping).
6. Ative a integração e monitore os primeiros syncs no log.

Para webhooks, copie a URL do endpoint fornecida pelo SniperSell e configure-a no sistema externo como destino de notificações.

Gmail Sync

Sincronização bidirecional de emails. Emails enviados e recebidos no Gmail aparecem automaticamente no histórico do contato no CRM. Suporta tracking de abertura e resposta.

Google Calendar

Reuniões agendadas no SniperSell aparecem no Google Calendar e vice-versa. Vinculação automática a deals e contatos. Suporte a salas de reunião e convites.

Omie ERP

Sincronização de contratos, faturas e clientes. Detecção automática de divergências entre CRM e ERP. Importação de catálogo de produtos e serviços.

Webhooks (Inbound/Outbound)

Crie endpoints para receber dados externos ou configure disparos automáticos para eventos do SniperSell. Suporta headers customizados, retry automático e assinatura HMAC.

API REST

API completa com endpoints para todas as entidades: contatos, deals, tickets, atividades. Autenticação OAuth2, rate limiting, paginação e filtros avançados.

Zapier / Make / n8n

Conectores para plataformas de automação. Triggers (eventos do SniperSell) e Actions (operações no SniperSell) prontos para uso em fluxos no-code.

Fluxo: Deal Fechado → Faturamento no ERP

1. Vendedor move deal para a etapa "Fechado/Ganho" no CRM.
2. SniperSell dispara webhook outbound para o Omie ERP.
3. O ERP recebe os dados do deal (cliente, valor, produtos) e cria a ordem de serviço.
4. O sync log registra a operação com status de sucesso.
5. Se houver erro, o sistema retenta automaticamente até 3 vezes.

Fluxo: Lead Externo → CRM

1. Formulário externo (site, landing page de terceiro) envia dados para o webhook inbound do SniperSell.
2. O payload é validado e mapeado para os campos do CRM.
3. Um novo contato é criado automaticamente com a origem "Webhook".
4. O lead entra na cadência de prospecção configurada.

Fluxo: Automação via Zapier

1. Configure um Zap com trigger "Novo Deal no SniperSell".
2. Adicione ações: enviar Slack, atualizar planilha, criar tarefa no Asana.
3. O Zap executa automaticamente a cada novo deal criado.

Credenciais e Autenticação

Cada integração armazena suas credenciais de forma segura (criptografadas). Para Gmail e Calendar, o fluxo OAuth2 é utilizado — nenhuma senha é armazenada. Para APIs externas, chaves são guardadas com criptografia AES-256.

Regras de Sincronização

Configure a direção (SniperSell → Externo, Externo → SniperSell, ou bidirecional), frequência (tempo real, a cada hora, diário) e filtros (ex: sincronizar apenas deals acima de R$ 10.000).

Field Mapping

Mapeie campos do SniperSell para campos do sistema externo. Suporta transformações simples: concatenar nome + sobrenome, formatar CNPJ, converter moeda. Campos não mapeados são ignorados.

Retry e Error Handling

Configure quantas tentativas o sistema faz em caso de erro (padrão: 3). Defina intervalo entre retries (exponential backoff). Receba alertas por email quando uma integração falhar repetidamente.

Rate Limiting

Defina limites de requisições por minuto para evitar throttling em APIs externas. O sistema respeita headers de rate limit retornados pelos serviços conectados.

Módulos que se beneficiam das integrações

• CRM Pipeline — Sincroniza deals, contatos e atividades com ERPs e ferramentas externas.
• Email — Gmail sync para histórico completo de comunicação no CRM.
• Agenda — Google Calendar para sincronização bidirecional de reuniões.
• Financeiro — Omie ERP para contratos, faturas e conciliação.
• Helpdesk — Webhooks outbound para notificar sistemas externos sobre tickets.
• Analytics — Dados de todas as integrações alimentam os dashboards automaticamente.

As integrações funcionam como a camada de conectividade do SniperSell, garantindo que dados fluam entre todos os módulos e sistemas externos sem intervenção manual.

Preciso de conhecimento técnico para configurar integrações?

Para integrações nativas (Gmail, Calendar, Omie), não. O fluxo é guiado com poucos cliques. Para webhooks e API REST, é recomendável ter familiaridade com conceitos de integração ou contar com suporte técnico.

As integrações são em tempo real?

Webhooks são em tempo real. Sincronizações de ERP podem ser configuradas para tempo real ou batch (a cada hora, diariamente), dependendo do volume de dados e da capacidade da API externa.

O que acontece se a integração falhar?

O sistema retenta automaticamente (configurável). Erros são registrados no sync log com detalhes do problema. Se as retentativas falharem, um alerta é enviado ao administrador por email.

Posso ter múltiplas contas Gmail conectadas?

Sim. Cada usuário pode conectar sua própria conta Gmail. Os emails são sincronizados individualmente, respeitando as permissões de cada usuário no CRM.

Emails do Gmail não estão aparecendo no CRM

Causa: Token OAuth expirado ou permissões revogadas no Google.

Solução: Acesse Integrações → Gmail → Reconectar. Autorize novamente as permissões solicitadas. Verifique se o email do contato no CRM corresponde exatamente ao endereço de envio/recebimento.

Webhook retornando erro 401

Causa: Chave de autenticação inválida ou expirada no sistema externo.

Solução: Gere uma nova chave de API nas configurações da integração e atualize no sistema externo. Verifique se headers de autenticação estão sendo enviados corretamente.

Sincronização do Omie duplicando registros

Causa: Campo de identificação único (CNPJ, código do cliente) não mapeado corretamente.

Solução: Revise o field mapping e garanta que um campo único (ex: CNPJ) esteja mapeado como chave de deduplicação. O sistema usará esse campo para atualizar registros existentes em vez de criar novos.

Rate limit excedido na API externa

Causa: Muitas requisições em curto período.

Solução: Reduza a frequência de sincronização nas configurações. O sistema implementa backoff automático, mas pode ser necessário ajustar o intervalo manualmente para APIs com limites rígidos.