Guia de integração
Como gerar o token de API do seu ERP
O Fiber Desk conversa com o seu ERP usando uma credencial que você gera lá dentro. Abaixo está o caminho exato em cada sistema. Escolha o seu, siga os passos e cole os dados em Integrações, no painel.
Caminhos conferidos na documentação oficial de cada fornecedor em 31 de agosto de 2026. Cada guia traz o link da fonte: se a sua versão do ERP tiver um menu diferente, é ali que você confirma.
IXC Soft
No IXC o token nasce colado a um USUÁRIO. Você cria um usuário só para a integração e marca a permissão de API: o token aparece sozinho no cadastro dele.
O que o Fiber Desk vai pedir
Base URL
O endereço do seu IXC, como você acessa no navegador. Ex.: https://seuprovedor.ixcsoft.com.br
Token IXC
O ID do usuário e o token, juntos, separados por dois-pontos: 9:abc123… O Fiber Desk converte para base64 sozinho.
Onde encontrar essas informações
- Abra Configurações → Usuários → Usuário É o mesmo cadastro dos usuários que entram no sistema. O token de API mora dentro dele.
- Clique em Novo e crie um usuário exclusivo para a integração Não reaproveite o seu login. Com usuário próprio, o log de alterações do IXC mostra o que foi ação de gente e o que foi ação da integração. Compartilhar login apaga essa diferença.
- Na seção API, marque "Permite acesso a API" O token é gerado automaticamente ao marcar essa opção. Salve e copie o valor.
- Anote também o ID do usuário O Fiber Desk precisa dos dois juntos, no formato
ID:TOKEN. O ID é o número do registro do usuário no IXC, não o nome dele. - Em "Redes permitidas", libere o IP do Fiber Desk Esse campo é uma lista branca de IPs, separados por ponto e vírgula. Deixando em branco o IXC aceita de qualquer origem; preenchido com o IP errado, ele recusa tudo em silêncio. Peça o IP ao suporte do Fiber Desk antes de preencher.
O que costuma dar errado
- O token é do USUÁRIO. Se alguém apagar ou desativar esse usuário no IXC, a integração para.
- O campo do Fiber Desk aceita
ID:TOKENouusuário:senha. O primeiro é o recomendado. - "Redes permitidas" é a causa nº 1 de integração que autentica no teste e falha em produção.
SGP
No SGP a credencial tem duas partes: o TOKEN e o APP. As duas são obrigatórias, e o App é o nome que você define, não um código gerado.
O que o Fiber Desk vai pedir
Base URL
O endereço do seu SGP. Ex.: https://seuprovedor.sgp.net.br
Token
O token gerado em Administração → Integrações → Tokens.
App ID
O NOME do app vinculado ao token. É você quem define, e ele vai sem espaços.
Onde encontrar essas informações
- Abra Administração → Integrações → Tokens Essa é a tela onde os tokens de API do SGP são criados e listados.
- Clique em Adicionar Token Em "Nome do Token", escreva algo que identifique a integração, como
Fiber Desk. Esse nome é só para você: ele não é usado na API. - No campo App, escolha um existente ou crie com o "+" Ao criar, o campo Nome precisa ser contínuo, sem espaços (por exemplo
fiberdesk). Diferente do nome do token, este valor É usado na API: é ele que você vai colar em "App ID" no Fiber Desk. - Confira o status e as permissões Deixe o token Ativo. Se o provedor quiser que a plataforma emita 2ª via, a permissão de baixar títulos precisa estar liberada para esse token.
- Salve e copie o token Guarde o token e o nome do App: os dois vão para o Fiber Desk, em campos separados.
O que costuma dar errado
- Token sem App não autentica. É o erro mais comum: copiar só o token e deixar o "App ID" vazio.
- O "Nome do Token" e o "Nome do App" são coisas diferentes. Quem vai para a API é o do APP.
- Se houver restrição de hosts/rotas no token, o Fiber Desk precisa estar liberado ali.
Hubsoft
O Hubsoft usa OAuth2 e pede QUATRO dados: Client ID, Client Secret, usuário e senha. Os dois primeiros aparecem sozinhos depois que você habilita a API no usuário.
O que o Fiber Desk vai pedir
Base URL
O HOST que o Hubsoft mostra na aba API do usuário.
Client ID
Aba API do usuário. É um número, não um e-mail.
Client Secret
Aba API do usuário, ao lado do Client ID.
Usuário (e-mail da API)
O e-mail do usuário que você criou para a integração.
Senha do usuário da API
A senha que você definiu para esse usuário.
Onde encontrar essas informações
- Crie um usuário exclusivo para a integração Em Configuração → Geral → Usuários. Guarde o e-mail e a senha: os dois vão para o Fiber Desk.
- Abra Configuração → Geral → Usuários → Ações → Editar Edite o usuário que você acabou de criar.
- Vá até a aba API e ative o acesso Marque a API que esse usuário poderá acessar e salve.
- Copie HOST, CLIENT ID e CLIENT SECRET Eles aparecem na própria aba API depois de salvar. O HOST é o que vai no campo "Base URL" do Fiber Desk.
- Libere as permissões dos recursos Com o acesso ligado, defina o que esse usuário pode ler pela API: cliente, contrato, financeiro e atendimento. Sem a permissão de financeiro, a 2ª via não sai, e o erro que aparece é de "cliente não encontrado", que manda procurar no lugar errado.
O que costuma dar errado
- São quatro credenciais, não duas. Client ID e Secret sozinhos não autenticam no Hubsoft.
- O Client ID é numérico. Se você colou um e-mail ali, está no campo errado.
- Nunca use o mesmo usuário de API em dois sistemas: as permissões de um acabam limitando o outro.
- A permissão de FINANCEIRO é a que mais falta, e o sintoma engana (parece cadastro não encontrado).
MK-Auth
No MK-Auth as credenciais também ficam dentro do usuário, numa aba API, e são um par de Client ID e Client Secret.
O que o Fiber Desk vai pedir
Base URL
O endereço do seu MK-Auth. Ex.: https://seuprovedor.mkauth.com.br
Client ID
Aba API do usuário, em Controle de usuários.
Client Secret
Aba API do usuário, ao lado do Client ID.
Onde encontrar essas informações
- Abra o menu CADASTROS → Controle de usuários É a tela onde ficam os usuários do sistema.
- Escolha o usuário da integração e clique em API Use um usuário criado só para isso, pelo mesmo motivo dos outros ERPs: separar no log o que foi gente do que foi integração.
- Copie o client_id e o client_secret Os dois aparecem nessa mesma página.
- Conceda as permissões ao usuário Ainda nessa tela. Libere leitura de cliente, contrato e financeiro para a 2ª via funcionar.
O que costuma dar errado
- O MK-Auth troca client_id e client_secret por um token temporário a cada consulta. Isso é normal e o Fiber Desk cuida disso sozinho.
- Instalações antigas do MK-Auth (anteriores à 18.01) têm uma API diferente. Se a sua for dessas, fale com o suporte antes.
Voalle
No Voalle existe um detalhe que reprova a maioria das primeiras tentativas: o usuário precisa ser marcado como INTEGRADOR, senão a autenticação é recusada.
O que o Fiber Desk vai pedir
Base URL
O endereço do seu Voalle. Ex.: https://seuprovedor.voalle.com.br
Bearer Token
O token gerado no cadastro de Integradores.
Onde encontrar essas informações
- Em Configurações → Usuários, crie o usuário da integração Um usuário novo, dedicado ao Fiber Desk.
- Marque a opção "Usuário integrador" Este é o passo que costuma faltar. Com ele marcado, o usuário não consegue mais entrar no ERP pela tela, só pela API — e é exatamente esse o objetivo. Sem marcar, a API de autenticação responde "Não Autorizado", e a mensagem não diz que o motivo é este.
- Gere o token na rotina de Integradores O token criado ali é único para a integração. É ele que vai no campo "Bearer Token" do Fiber Desk.
O que costuma dar errado
- "Não Autorizado" na primeira tentativa quase sempre é o "Usuário integrador" desmarcado.
- O usuário integrador não entra mais no ERP pela tela. Isso é esperado, não é defeito.
API genérica
Para ERP próprio ou um sistema fora desta lista. Você aponta o Fiber Desk para a sua API e ela responde no formato que a plataforma espera.
O que o Fiber Desk vai pedir
Base URL
O endereço da sua API.
Token
A credencial que a sua API exige, enviada no cabeçalho de cada chamada.
Onde encontrar essas informações
- Fale com o suporte do Fiber Desk antes de começar Diferente dos outros, este caminho depende do formato que a sua API devolve. A equipe passa o contrato esperado (quais rotas, quais campos) para o seu desenvolvedor.
O que costuma dar errado
- Não é preciso reescrever a sua API: na maioria dos casos basta expor as consultas de cliente, contrato e faturas.
Travou em algum passo?
Manda mensagem que a gente gera a credencial junto com você, com a tela do seu ERP aberta. É mais rápido que trocar print.
Falar com o suporte