Conecta Trinks
      Voltar para o início
      1. Central de Ajuda da Trinks
      2. Conecta Trinks

      FAQ Completo: Conecta Trinks e Integrações

      Tire suas dúvidas sobre o Conecta Trinks, integrações nativas, parceiros, API e Webhooks em um só lugar

      Este documento serve como o guia definitivo para gestores de negócios de beleza e bem-estar, bem como para desenvolvedores que desejam expandir as funcionalidades da Trinks.

      O objetivo deste FAQ é esclarecer desde os conceitos fundamentais do Conecta Trinks até os detalhes técnicos de implementação da API, funcionando como uma fonte central de conhecimento para maximizar o potencial das integrações e impulsionar o crescimento do seu negócio.

      1. Visão geral do Conecta Trinks

      Em um mercado cada vez mais competitivo, a eficiência operacional é um diferencial estratégico.

      Uma plataforma de integrações como o Conecta Trinks é crucial, pois permite que diferentes sistemas "conversem" entre si, automatizando processos que antes exigiam tempo e esforço manual.

      A conexão entre sistemas não só otimiza a gestão, mas também abre portas para novas estratégias de crescimento e fidelização, sendo um pilar para o sucesso no setor de beleza e bem-estar.

      1.1. P: O que é o Conecta Trinks?

      • R: O Conecta Trinks é uma plataforma aberta e completa que conecta o sistema de gestão da Trinks a dezenas de outras ferramentas de mercado. Ele foi projetado para automatizar tarefas, desde o financeiro até a comunicação com o cliente, permitindo que seu negócio opere no "modo automático". Com ele, você reduz tarefas manuais e ganha mais tempo para focar no que realmente importa: o crescimento e a experiência do cliente.

      1.2. P: Quais são os principais benefícios de usar as integrações do Conecta Trinks?

      • R: Os benefícios se traduzem diretamente em resultados para o seu negócio:
        • Automação de Processos: Elimine tarefas manuais, como o fechamento de caixa, a conciliação financeira e o envio de lembretes, reduzindo erros e otimizando o tempo da sua equipe.
        • Economia de Tempo: Com menos processos manuais, sua equipe pode se dedicar a atividades mais estratégicas e ao atendimento ao cliente.
        • Melhora na Experiência do Cliente: Ofereça conveniência com agendamento online 24/7, programas de fidelidade automáticos e uma comunicação mais próxima e personalizada.
        • Aumento de Faturamento: Impulsione a receita através de estratégias de fidelização que aumentam a frequência dos clientes, a recuperação de clientes inativos e um maior ticket médio por visita.
        • Liberdade de Escolha: Conecte a Trinks às suas ferramentas preferidas, criando um ecossistema de gestão sob medida para as suas necessidades.
        • Suporte Especializado: Conte com documentação completa, tutoriais e acompanhamento técnico para garantir o sucesso das suas integrações.

      1.3. P: Existe algum custo adicional para usar as integrações?

      • R: A plataforma Conecta Trinks e o acesso à nossa API são recursos oferecidos aos clientes Trinks. No entanto, é importante notar que os serviços dos nossos parceiros (como Cloudia, CRM Bônus, etc.) possuem seus próprios planos e custos de assinatura. Para as conexões nativas, como Stone e Pagar.me, podem existir taxas de transação, mas elas geralmente vêm acompanhadas de condições e benefícios exclusivos para clientes Trinks, como a isenção de aluguel da maquininha.

      Agora que entendemos o conceito, vamos explorar como essas integrações funcionam na prática para os gestores de salão.

      2. Para gestores e donos de estabelecimentos: Maximizando sua operação

      Esta seção foi elaborada para você, gestor, que busca soluções práticas para os desafios do dia a dia. As perguntas a seguir demonstram, sem jargões técnicos, como cada integração pode resolver problemas específicos, otimizar sua operação e impulsionar resultados concretos no seu negócio.

      2.1. Conexões Nativas: Ferramentas integradas pela Trinks

      2.1.1. P: Como a integração com Stone & Pagar.me realmente me ajuda no dia a dia?

      • R: Essa integração automatiza seu fluxo financeiro e elimina uma das maiores fontes de erro: a digitação manual de valores. Na prática, ao fechar uma conta no sistema Trinks, o valor exato é enviado diretamente para a maquininha. Isso elimina erros de digitação, a conciliação é automática e o split de pagamentos facilita a divisão de comissões. Além disso, ela oferece duas ferramentas poderosas para o dia a dia:
        • Link de pagamento: Ideal para vender pacotes, produtos ou receber adiantamentos online, de forma segura e prática.
        • Conta digital integrada: Permite pagar comissões em lote, fazer PIX e controlar todo o extrato financeiro diretamente no sistema Trinks, centralizando a gestão.

      2.1.2. P: De que forma a CRM Bônus pode aumentar meu faturamento?

      • R: A CRM Bônus funciona com um conceito chamado "giftback". Ao final de cada compra, o sistema oferece automaticamente um bônus (um valor em dinheiro) para o cliente usar na próxima visita. Esse incentivo tem dois efeitos poderosos: primeiro, aumenta a frequência dos clientes, pois eles se sentem motivados a retornar para usar o bônus. Segundo, aumenta o ticket médio, já que o cliente tende a gastar um pouco mais do que o valor do bônus. O melhor de tudo é que o processo é 100% automático e integrado ao seu caixa.

      2.1.3. P: Como posso usar a integração com o WhatsApp para reduzir as faltas?

      • R: A principal vantagem desta integração é a redução da taxa de no-show (não comparecimento). O sistema envia lembretes de agendamento automáticos um dia antes do horário marcado, diminuindo significativamente os esquecimentos.
        Além disso, ele automatiza o envio de confirmações, mensagens de aniversário e pesquisas de satisfação, e ainda ajuda a trazer de volta clientes inativos com convites automáticos, fortalecendo o relacionamento e aumentando a recorrência sem exigir esforço manual da sua equipe.

      2.1.4. P: Como as integrações com Facebook, Instagram e Google geram mais agendamentos?

      • R: Elas encurtam a jornada do cliente. Com o botão "Agendar agora" no seu perfil do Facebook e Instagram, um seguidor pode agendar um horário imediatamente, sem sair da rede social. Da mesma forma, com o "Reserve com o Google", um cliente que encontra seu salão no Google Maps ou na busca pode agendar direto na tela de resultados. Isso elimina atritos e converte o interesse em um agendamento real, com tudo centralizado na sua agenda Trinks. Além disso, a integração com o Google Analytics fornece dados valiosos sobre a origem dos seus clientes e os serviços mais procurados em seu site.

      2.2. Ecossistema de parceiros: Soluções especialistas

      2.2.1. P: Além das integrações mencionadas, que outros tipos de parceiros existem no ecossistema Trinks?

      • R: O ecossistema Trinks é vasto e projetado para atender diversas necessidades de gestão. Além das ferramentas mais conhecidas, você encontra soluções como:
        • Lucy.IA: Uma assistente de vendas com inteligência artificial que conversa com clientes, sugere serviços e recupera agendamentos não concluídos, transformando interações em vendas.
        • Mi Asistente: Um CRM completo para organizar o histórico de cada cliente, permitindo um relacionamento mais próximo e personalizado, o que ajuda a identificar oportunidades de venda e fidelização.
        • Trinks BI: Uma ferramenta de Business Intelligence para redes e franquias, que consolida dados de múltiplas unidades em dashboards estratégicos, permitindo uma visão 360º do negócio.
        • Lovty: Assistente inteligente para WhatsApp que automatiza conversas, agenda horários e se adapta ao estilo da sua marca.

      2.2.2. P: A integração com a Cloudia (agendamento por WhatsApp) funciona mesmo sem ninguém da minha equipe online?

      • R: Sim, funciona 100% no piloto automático. A Cloudia é um chatbot (robô de atendimento) que opera 24 horas por dia, 7 dias por semana. Ele consulta sua agenda Trinks em tempo real para verificar a disponibilidade de profissionais e horários, e realiza o agendamento de forma totalmente autônoma, mesmo que seu salão esteja fechado ou sua equipe ocupada.

      2.2.3. P: A Lovty consegue atender meus clientes automaticamente, mas ainda mantendo um atendimento com o estilo do meu negócio?

      • R: Sim. Além de responder clientes 24 horas por dia de forma automática, a Lovty permite personalizar o tom e a “voz” da assistente para combinar com a identidade do seu negócio. Assim, você automatiza o atendimento sem abrir mão de um toque pessoal.

      2.2.4. P: Como eu começo a usar uma integração de parceiro como F360, Spot Metrics ou Retorne.app?

      • R: O processo é simples e geralmente segue dois passos. Primeiro, você precisa ser cliente do parceiro desejado, ou seja, ter uma conta ativa com ele. Segundo, dentro do sistema Trinks, na área de integrações, você ativa a conexão. Normalmente, isso envolve apenas copiar uma chave de acesso (credencial) fornecida pelo parceiro e colá-la no campo correspondente dentro da Trinks.

      2.2.4. P: Preciso ter conhecimento técnico para ativar essas integrações?

      • R: Não, nenhum conhecimento técnico é necessário. As integrações com nossos parceiros foram projetadas para serem ativadas de forma simples e intuitiva. O processo é guiado e não exige nenhuma programação.

      Para aqueles que desejam ir além das integrações prontas e criar soluções personalizadas, a próxima seção detalha tudo sobre nossa API e Webhooks.

      3. Para desenvolvedores: Guia técnico da API e Webhooks

      Bem-vindo(a), desenvolvedor(a). Esta seção é mais do que um guia técnico: é o seu portal para conectar sua solução à maior plataforma de gestão para beleza e bem-estar do Brasil.

      Nossa API foi projetada para ser robusta, escalável e fácil de usar, permitindo que você exponha sua solução para uma base de milhares de clientes engajados. O objetivo é tornar sua jornada de desenvolvimento ágil e eficiente, fornecendo as ferramentas para você construir integrações incríveis que resolvem problemas reais.

      3.1. Acesso e Autenticação

      3.1.1. P: Como obtenho uma chave de API (API Key) para começar a desenvolver?

      • R: O processo é composto por 3 passos:
        1. O responsável técnico pelo desenvolvimento deve estar cadastrado no sistema Trinks com um perfil válido.
        2. É necessário realizar uma solicitação formal através do canal Fale Conosco, informando o nome e o e-mail do usuário responsável.
        3. Após a liberação pela equipe Trinks (em até 48 horas), o token estará disponível para visualização e/ou geração na área 'Meu Cadastro' do sistema.

      3.1.2. P: Como funciona a autenticação na API?

      • R: A autenticação utiliza o método ApiKey. Para se autenticar, você deve incluir sua chave secreta em todas as requisições, enviando-a através do cabeçalho (header) HTTP X-Api-Key.
      • Importante: Sua chave de API é secreta e intransferível. Trate-a como uma senha, pois ela concede acesso para ler e modificar dados em seus estabelecimentos.

      3.2. Regras e limites da API

      3.2.1. P: Quais são os limites de requisição e o que acontece se eu ultrapassá-los?

      • R: A API possui os seguintes limites por chave:
        • 60 requisições por minuto
        • 5.000 requisições por mês (padrão)
      • Ao exceder o limite de minuto ou mês, a API retornará o código de erro HTTP 429 Too Many Requests. Suas requisições serão bloqueadas até o início do próximo ciclo (o próximo minuto ou o próximo mês, dependendo do limite atingido).

      3.2.2. P: Por que ao listar clientes ou agendamentos, a API só retorna um número limitado de registros?

      • R: Isso ocorre devido à paginação, um mecanismo essencial para garantir a performance e a estabilidade da API. Todos os endpoints de listagem retornam no máximo 50 itens por página. Para obter todos os registros, sua aplicação deve ler os campos de paginação na resposta (como page, totalPages, totalRecords) e fazer requisições subsequentes para cada página até que todos os dados tenham sido recuperados.

      3.3. Webhooks: Notificações em tempo real

      3.3.1. P: Qual a diferença entre usar a API e os Webhooks?

      • R: A forma mais fácil de entender é pensar em um modelo ativo versus um passivo.
        • API (Ativo): Sua aplicação busca ativamente informações na Trinks. Ex: "Trinks, me dê a lista de agendamentos de hoje".
        • Webhooks (Passivo): A Trinks envia passivamente informações para a sua aplicação em tempo real, assim que um evento acontece. Ex: "Sua aplicação, um novo agendamento acabou de ser criado".
      • Para uma integração robusta e sincronizada, a melhor abordagem é combinar o uso de ambos.

      3.3.2. P: Configurei um endpoint para Webhooks, mas não estou recebendo notificações. O que pode ser?

      • R: A causa mais comum é a falta de confirmação da assinatura. Ao cadastrar seu endpoint, a Trinks (via Amazon SNS) envia uma primeira notificação contendo uma URL especial chamada SubscribeURL. Sua aplicação obrigatoriamente precisa fazer uma requisição GET a essa URL para confirmar a assinatura e começar a receber os eventos. Sem essa confirmação, nenhum webhook será enviado.

      3.3.3. P: Quais eventos posso receber via Webhook?

      • R: Você pode ser notificado sobre uma variedade de eventos cruciais da operação. O campo Action no payload indica a natureza da mudança, enquanto o TipoDeEvento identifica o evento específico.

      Evento

      TipoDeEvento

      Disparo (O que acontece no Trinks)

      Ação no Payload (Action)

      Conta

      		      

      Fechamento de Conta

      1

      Uma conta é finalizada e paga.

      1: Inclusão

      Estorno de Conta

      2

      Uma conta fechada é estornada.

      9: Estorno

      Cliente

      		      

      Cadastro de Cliente

      3

      Um novo cliente é criado.

      1: Inclusão

      Alteração de Cliente

      4

      Os dados de um cliente são atualizados.

      2: Alteração

      Profissional

      		      

      Cadastro de Profissional

      5

      Um novo profissional é criado.

      1: Inclusão

      Alteração de Profissional

      6

      Os dados de um profissional são atualizados.

      2: Alteração

      Inativação de Profissional

      7

      Um profissional é inativado.

      3: Exclusão

      Estabelecimento

      		      

      Cadastro de Estabelecimento

      8

      Uma nova unidade é criada.

      1: Inclusão

      Exclusão de Estabelecimento

      9

      Uma unidade é desassociada.

      3: Exclusão

      Alteração de Estabelecimento

      10

      Os dados de uma unidade são atualizados.

      2: Alteração

      Agendamento

      		      

      Inclusão de Agendamento

      11

      Um novo agendamento é criado.

      1: Inclusão

      Alteração de Agendamento

      12

      Um agendamento é modificado.

      2: Alteração

      Exclusão de Agendamento

      13

      Um agendamento é cancelado.

      3: Exclusão

      3.4. Tratamento de erros comuns

      3.4.1. P: O que significam os principais códigos de erro HTTP retornados pela API?

      • R:
        • 400 Bad Request: A requisição está malformada. Verifique a sintaxe do JSON enviado ou os parâmetros da URL.
        • 401 Unauthorized: Falha na autenticação. Sua X-Api-Key está faltando ou é inválida.
        • 403 Forbidden: Você não tem permissão para acessar o recurso solicitado.
        • 404 Not Found: O recurso específico (ex: um agendamento com o ID informado) não foi encontrado.
        • 429 Too Many Requests: Você excedeu o limite de requisições por minuto ou por mês.
        • 5xx Server Error: Ocorreu um erro inesperado do nosso lado. Tente novamente mais tarde.

      3.4.2. P: Recebi um erro 409 Conflict ao tentar criar um agendamento. O que isso significa?

      • R: Este erro indica um conflito de disponibilidade. Significa que o horário que sua aplicação tentou agendar para um profissional já foi ocupado por outro agendamento. A melhor prática para tratar esse erro é informar ao usuário que o horário não está mais disponível e sugerir que ele consulte novamente a lista de horários livres para escolher outra opção.

      3.5. Melhores Práticas de Implementação

      3.5.1. P: Quais são as boas práticas recomendadas para uma integração estável e eficiente?

      • R: Para garantir o sucesso e a estabilidade da sua integração, recomendamos fortemente as seguintes práticas:
        • Controle de taxa (Throttling): Implemente um mecanismo na sua aplicação para garantir que ela não exceda o limite de 60 requisições por minuto.
        • Uso de cache inteligente: Armazene em cache dados que mudam com pouca frequência, como a lista de serviços, profissionais e formas de pagamento. Isso reduz drasticamente o consumo da sua cota mensal de requisições.
        • Logs detalhados: Mantenha um registro completo de todas as requisições enviadas e respostas recebidas. Isso é indispensável para depurar problemas e monitorar a saúde da integração.
        • Mecanismos de retentativa (Retry): Para erros 5xx (erros de servidor), implemente uma lógica de retentativa com backoff exponencial (aumentando o tempo de espera a cada tentativa). Para erros 429, a retentativa deve aguardar o próximo ciclo de limite.
        • Segurança da chave de API: Armazene sua X-Api-Key de forma segura, usando variáveis de ambiente ou um serviço de gerenciamento de segredos. Nunca a exponha no código-fonte ou em repositórios públicos.