Perguntas frequentes sobre Integrações
Respostas rápidas para as dúvidas mais comuns na hora de conectar o sistema a gateways de pagamento, marketplaces, e-mail e outros serviços externos.
Onde configuro as integrações no sistema?
Seção intitulada “Onde configuro as integrações no sistema?”No menu lateral, vá em Sistema → Integrações. Essa é a tela do Hub de Integrações, um painel único onde você vê tudo que está disponível, filtra por categoria ou status, conecta novos serviços e acompanha o que já está em uso.
Para conectar, localize o card do serviço, clique em Conectar e informe as credenciais. Veja o passo a passo em Hub de Integrações.
Quais serviços posso integrar ao sistema?
Seção intitulada “Quais serviços posso integrar ao sistema?”O catálogo cobre várias categorias: pagamentos (Pagar.me, Stripe, Mercado Pago), e-commerce e marketplaces, comunicação (WhatsApp e e-mail), além de bancos, CRM, redes sociais e inteligência artificial. Cada categoria mostra, no próprio Hub, quantas integrações ela reúne.
Para ver tudo o que está disponível e o fluxo de configuração, comece pela visão geral de Integrações.
Onde consigo as chaves de API e as credenciais de cada integração?
Seção intitulada “Onde consigo as chaves de API e as credenciais de cada integração?”As credenciais são geradas no próprio serviço parceiro (Pagar.me, Stripe, Mercado Pago, etc.), não no sistema. Cada serviço tem seu painel onde você cria a chave de API.
Na janela de conexão de cada integração há o aviso Como obter as credenciais, que explica onde gerar a chave e traz o link para a documentação oficial daquele serviço.
Como testo uma integração sem mexer com dados reais?
Seção intitulada “Como testo uma integração sem mexer com dados reais?”Use o ambiente de homologação (sandbox), quando o serviço oferece essa opção. Nele você valida a configuração sem gerar cobranças, pedidos ou mensagens de verdade.
- Ao criar a conexão, marque Ambiente de homologação (sandbox).
- A conexão recebe o selo Homologação no card e entra no contador de Homologação, no topo da tela.
Posso conectar mais de uma conta do mesmo serviço?
Seção intitulada “Posso conectar mais de uma conta do mesmo serviço?”Sim. Um mesmo serviço aceita várias conexões — por exemplo, duas chaves de API diferentes.
Na integração já conectada, clique no botão ⋯ e escolha Nova conexão, ou use Nova conexão dentro da janela do serviço. O card passa a mostrar o número de conexões ativas.
Dá para desligar uma integração por um tempo sem apagar as credenciais?
Seção intitulada “Dá para desligar uma integração por um tempo sem apagar as credenciais?”Sim. Desligue a chave Ativa no card para pausar a integração. Ela continua configurada, com as credenciais salvas, mas para de operar até você ligar a chave de novo.
Isso é diferente de Desconectar, que encerra a integração de vez. Para pausas temporárias, prefira sempre pausar.
O que significa a etiqueta “Com erro” no card da integração?
Seção intitulada “O que significa a etiqueta “Com erro” no card da integração?”Significa que a última comunicação com o serviço falhou. Costuma ser credencial vencida ou revogada, chave digitada errada ou instabilidade no serviço parceiro.
Abra a integração e clique em Verificar status para testar a conexão. Se as credenciais mudaram, atualize-as em Configurar. Veja mais em Hub de Integrações.
Se eu desconectar uma integração, perco o histórico?
Seção intitulada “Se eu desconectar uma integração, perco o histórico?”Não. Ao desconectar, a integração volta a aparecer como disponível, mas o histórico é preservado.
Use o menu ⋯ → Desconectar. Se a ideia é só interromper por um tempo, prefira pausar a chave em vez de desconectar.
Como faço para os e-mails do sistema saírem da conta da minha empresa?
Seção intitulada “Como faço para os e-mails do sistema saírem da conta da minha empresa?”Configure a integração SMTP com o servidor de e-mail da sua empresa. A partir daí, os envios do sistema (pedidos, notas fiscais) saem pela sua conta, com o seu endereço como remetente.
As vantagens: uma cópia fica na Caixa de Saída da sua conta, as respostas dos clientes caem no seu e-mail e a mensagem passa mais credibilidade. Veja o passo a passo em Integração SMTP.
Qual porta e tipo de segurança devo usar na configuração do SMTP?
Seção intitulada “Qual porta e tipo de segurança devo usar na configuração do SMTP?”A combinação mais recomendada é a porta 587 com segurança STARTTLS. As opções mais comuns são:
- 587 — com criptografia STARTTLS (recomendada).
- 465 — com criptografia TLS/SSL.
- 25 — sem criptografia (evite; use só se o provedor exigir).
O tipo de Segurança precisa combinar com a porta escolhida. Na dúvida, consulte a página de ajuda ou o suporte do seu provedor de e-mail.
A senha do meu e-mail do Google ou da Microsoft não funciona no SMTP. O que faço?
Seção intitulada “A senha do meu e-mail do Google ou da Microsoft não funciona no SMTP. O que faço?”Gere uma senha de aplicativo específica na conta do provedor e use ela no campo Senha, no lugar da senha normal. Provedores como Google e Microsoft não aceitam a senha comum da conta em conexões SMTP externas.
Depois de preencher, clique em Salvar e retestar conexão — o sistema confirma o acesso antes de ativar. Detalhes em Integração SMTP.
Para que serve o Linker e como sei se ele está rodando?
Seção intitulada “Para que serve o Linker e como sei se ele está rodando?”O Linker é um aplicativo que funciona como ponte entre o sistema e equipamentos e programas locais: TEF (cartão), balança, gaveta eletrônica e o ACBr.
Para saber se está ativo, veja o indicador Linker ativo no rodapé do PDV, ou abra o painel do aplicativo em http://localhost:5000. Em celular e tablet o indicador não aparece, porque o Linker é instalado no computador do caixa. Baixe e saiba mais em Linker.
Preciso instalar algum programa no computador para as integrações funcionarem?
Seção intitulada “Preciso instalar algum programa no computador para as integrações funcionarem?”Na maioria dos casos, não. Pagamentos, marketplaces, e-commerce, WhatsApp e SMTP funcionam direto na nuvem, sem instalar nada.
A exceção é quando há equipamento local envolvido: para TEF, balança e gaveta, é preciso instalar e manter o Linker rodando na máquina que opera o caixa.