SNDeskIntegrações
A Central de Integrações permite conectar o SNDesk a plataformas externas usadas pela empresa, como Bling, Omie, GestãoClick, Conta Azul, SuperLógica e Power BI. Cada integração depende das credenciais, permissões e autorizações liberadas na plataforma de origem.
Onde acessar
No sistema, acesse Configurações > APIs/Integrações. Na Central de Integrações, selecione a plataforma desejada e clique em Novo para iniciar a configuração. Para Power BI, use também a área de Relatórios > Relatório PowerBI, onde ficam o token, o modelo e os links da API.
Fluxo geral de configuração
Escolha a integração
Na Central de Integrações, localize o card da plataforma que será conectada ao SNDesk. O status informa se a integração está ativa, inativa ou em breve.
Clique em Novo
Com a integração selecionada, clique em Novo na parte inferior da tela para criar uma nova configuração.
Preencha os dados do SNDesk
Informe nome da integração, empresa vinculada, credenciais, tokens, chaves de API, ambiente e demais campos solicitados pelo tipo de integração.
Configure também a plataforma externa
Acesse a plataforma que será integrada e gere as credenciais necessárias, libere permissões, valide webhooks ou autorizações exigidas pelo fornecedor.
Salve e teste
Salve a configuração, execute um teste de conexão quando disponível e confirme se os dados esperados estão sendo sincronizados corretamente.
Integrações documentadas
Bling
Integração com ERP por aplicativo OAuth 2.0.
- Criação de aplicativo no Bling.
- Uso de Client ID e Client Secret.
- Autorização por escopos e geração de token.
Power BI
Consumo dos dados do SNDesk por API REST em relatórios do Power BI.
- Modelo
.pbitgerado pelo sistema. - Conexão manual por fonte Web.
- Endpoints de chamados e agendamentos.
Omie
Integração com ERP Omie usando App Key e App Secret.
- Requer usuário administrador.
- Credenciais obtidas em Meus Aplicativos ou Developer.
- Validação de app e permissões.
GestãoClick
Integração por API para clientes que usam GestãoClick como ERP.
- API pode exigir contratação adicional.
- Geração de Access Token.
- Uso de Secret Access junto ao token.
Conta Azul
Integração via OAuth 2.0 para rotinas financeiras, cadastrais ou administrativas.
- Uso de app de desenvolvimento ou produção.
- Fluxo com código de autorização.
- Access token e refresh token.
SuperLógica
Integração para condomínios, assinaturas ou gestão recorrente.
- Criação de aplicativo.
- Uso de App Token e Access Token.
- Permissões conforme usuário e produto.
Bling
A integração com a Bling utiliza um aplicativo cadastrado na própria plataforma, com URL de autorização informada pelo SNDesk, escopos selecionados conforme a necessidade da empresa e credenciais Client ID e Client Secret.
Criar o aplicativo na Bling
Entre na conta Bling, acesse a Central de Extensões, abra a Área do Integrador e clique em Criar novo aplicativo. Prossiga no cadastro e preencha os dados solicitados, como nome, descrição, links e informações de contato.
Iniciar a configuração no SNDesk
No SNDesk, acesse Configurações > APIs/Integrações, abra a aba Bling e clique em Novo. Copie o link de autorização gerado pelo SNDesk.
Informar o link e escopos na Bling
Cole o link de autorização no campo correspondente do aplicativo Bling, selecione somente os escopos necessários para a operação e salve o aplicativo.
Copiar Client ID e Client Secret
Depois de salvar, copie o Client ID e o Client Secret exibidos na Bling. Volte ao SNDesk, cole cada valor no campo correspondente e salve a configuração.
Gerar token e autorizar
No SNDesk, clique em Gerar Token. O usuário será direcionado para login e autorização na Bling. Ao concluir, a Bling redireciona de volta ao SNDesk e a integração fica pronta para uso.
Atenção aos escopos
Os escopos definem quais dados o aplicativo poderá acessar. Se um escopo for alterado depois, os usuários podem precisar autorizar novamente o aplicativo. Mantenha o Client Secret protegido e nunca publique essa credencial em prints, chamados ou mensagens abertas.
Power BI
O SNDesk disponibiliza dados para o Power BI por API REST em JSON. O cliente pode usar um modelo .pbit gerado pelo sistema ou configurar manualmente uma fonte Web no Power BI Desktop.
Modelo gerado pelo sistema
- Acesse a área de relatórios e localize Relatório PowerBI.
- Clique em Clique para gerar seu modelo com seus dados.
- Baixe o arquivo
.pbitgerado pelo sistema. - Abra o arquivo no Power BI Desktop.
- Clique em Atualizar para buscar os dados mais recentes.
Conexão manual por Web
- Gere ou copie o token na área de autorização da API.
- Escolha o endpoint de Chamados ou Agendamentos.
- Informe o período desejado ou mantenha o padrão.
- No Power BI Desktop, selecione uma nova fonte de dados do tipo Web.
- Cole a URL final e adicione o cabeçalho Authorization com o valor Bearer {token}.
| Endpoint | Finalidade | Formato |
|---|---|---|
/chamados?periodo={valor} | Consulta dados de chamados, clientes, status, categoria, departamento, técnico, orçamento e campos adicionais. | JSON |
/agendamentos?periodo={valor} | Consulta check-ins, checkouts, eventos, duração, chamado associado, técnico e status. | JSON |
Períodos aceitos
| Valor | Descrição |
|---|---|
mes_atual | Dados desde o primeiro dia do mês atual até hoje. |
mes_passado | Dados do primeiro ao último dia do mês anterior. |
semana_atual | Dados desde a última segunda-feira até hoje. |
semana_passada | Dados da segunda-feira ao domingo da semana anterior. |
3_meses ou 6_meses | Dados dos últimos 3 ou 6 meses a partir da data atual. |
dd/mm/aaaa_dd/mm/aaaa | Intervalo personalizado, como 01/01/2025_31/01/2025. |
ERPs e plataformas administrativas
| Plataforma | Como obter credenciais | O que informar no SNDesk |
|---|---|---|
| Omie | Usuário administrador acessa Meus Aplicativos ou a área Developer, abre o aplicativo e copia App Key e App Secret. | App Key, App Secret, empresa vinculada e demais campos exibidos pela integração. |
| GestãoClick | No ERP, acesse Meus aplicativos > API > Token e clique em Gerar token. A plataforma fornece Access Token e Secret Access. | Access Token, Secret Access e configurações exigidas pelo escopo da integração. |
| Conta Azul | No Portal do Desenvolvedor, configure a aplicação e siga o fluxo OAuth 2.0 por código de autorização, troca por token, renovação e chamadas autenticadas. | Credenciais OAuth, autorização concluída, tokens e empresa vinculada. |
| SuperLógica | Acesse Menu do usuário > Todos os usuários, localize a área de aplicativos do usuário, crie um novo app token e guarde App Token e Access Token. | App Token, Access Token, produto correspondente e permissões necessárias. |
Atenção antes de ativar
A integração depende tanto da configuração no SNDesk quanto da liberação correta dentro da plataforma externa. Se a plataforma não liberar API, token, permissão, webhook ou autorização necessária, a conexão não funcionará corretamente.
Erros comuns por integração
Antes de acionar o suporte, valide os pontos abaixo. A maioria das falhas de integração ocorre por credencial incorreta, permissão incompleta, ambiente divergente ou etapa de autorização não concluída.
| Integração | Erros mais frequentes | Como corrigir |
|---|---|---|
| Bling | Link de autorização colado no campo errado, escopos insuficientes, Client ID ou Client Secret com espaços extras, token não gerado ou autorização não concluída. | Revise o aplicativo na Área do Integrador, confirme o link do SNDesk, valide escopos, cole novamente as credenciais e clique em Gerar Token. |
| Power BI | Token ausente, cabeçalho Authorization sem Bearer, período inválido, endpoint incorreto ou modelo .pbit desatualizado. | Gere um token ativo, use Authorization: Bearer {token}, copie o Link Final novamente e atualize a fonte no Power BI Desktop. |
| Omie | App Key e App Secret invertidos, usuário sem permissão administrativa, aplicativo errado ou credencial redefinida no Omie. | Confirme as chaves no aplicativo correto, gere nova credencial se necessário e atualize os campos no SNDesk. |
| GestãoClick | API não contratada, Access Token ou Secret Access copiados incorretamente, token antigo ou ambiente divergente. | Confirme a liberação da API, gere novo token no GestãoClick e informe Access Token e Secret Access novamente no SNDesk. |
| Conta Azul | OAuth não concluído, código de autorização expirado, refresh token inválido ou credenciais de ambiente errado. | Refaça o fluxo de autorização, valide se o app está em produção ou desenvolvimento e renove os tokens quando necessário. |
| SuperLógica | App Token ou Access Token incorretos, token consultado por usuário diferente do criador do app ou permissões insuficientes. | Consulte os tokens com o usuário correto, gere novo app token se necessário e confirme o produto/permissão usados na integração. |
Checklist de validação
| Item | O que conferir | Status |
|---|---|---|
| Acesso administrativo | Usuário com permissão para gerar credenciais e autorizar integrações na plataforma externa. | Obrigatório |
| Credenciais | Token, chave de API, app key, app secret, client id, client secret, app token, access token, OAuth ou autorização equivalente, conforme o fornecedor. | Obrigatório |
| Ambiente | Confirmar se a integração será feita em produção, homologação ou ambiente de testes. | Atenção |
| Escopo | Definir quais dados serão enviados, recebidos ou sincronizados entre as plataformas. | Atenção |
| Token Power BI | Confirmar se o token de acesso está ativo e se a URL final está usando o período correto. | Atenção |
| Teste | Validar comunicação, retorno da API, logs e comportamento esperado após salvar. | Validação |
Perguntas frequentes
Próximo recomendado
Depois de configurar integrações, valide cadastros, importador de dados e parâmetros que possam influenciar o fluxo.