Your AI Connector Docs

Trafft

Para quem é isso? Esta integração é para empresas de agendamento que já gerenciam sua agenda no Trafft — salões, barbearias, clínicas, estúdios, consultores, oficinas de reparo. Se você não usa o Trafft, pode pular esta página.

Usa um sistema de agendamento diferente? Qualquer coisa com uma API ainda pode ser conectada: veja Conectando uma Ferramenta que Não Listamos, que cobre funções personalizadas, a API e webhooks.

O Trafft é uma plataforma de agendamento para empresas que vendem tempo: você configura seus serviços, sua equipe e seus locais, e os clientes reservam um horário. Conectar o Trafft ao Your AI Connector permite que seu Agente de IA gerencie todo o agendamento dentro do chat — verificando o que está realmente livre, reservando e confirmando o horário — em vez de enviar alguém para um link de agendamento e torcer para que concluam o processo.

O que o Trafft faz

O Trafft oferece a uma empresa de agendamentos:

  • Serviços com sua própria duração e preço
  • Equipe (funcionários) com seus próprios horários de trabalho
  • Um ou mais locais
  • Um site de agendamento e calendário para sua equipe

Ao conectar o Trafft ao Your AI Connector, essa mesma agenda se torna algo com que sua IA pode trabalhar no WhatsApp, SMS, Instagram ou no chat do seu site. A IA lê seus serviços e equipe, verifica o Trafft em busca de horários reais disponíveis e registra o agendamento diretamente no Trafft — para que o que sua equipe vê no Trafft seja sempre a realidade.

Conectando o Trafft

Antes de começar: você precisa de acesso à API no Trafft, que faz parte do plano Business do Trafft. Abra seu painel administrativo do Trafft e procure por Features & Integrations → API & Connectors. Se essa página não estiver lá, seu plano do Trafft ainda não a inclui e a conexão não pode ser feita.

  1. Na barra lateral esquerda, clique em Settings (ícone de engrenagem).
  2. Na barra lateral de Configurações, sob o grupo Integrations, clique em Booking & Calendar.
  3. Encontre o cartão Trafft e clique em Connect.
  1. Preencha o Endereço da empresa. Esta é a parte antes de .admin.trafft.com no endereço em que você faz login — se você faz login em acme.admin.trafft.com, digite acme. Colar o endereço completo também funciona; nós extraímos a parte correta dele. Conta Trafft white-label? Se o seu endereço Trafft terminar em .admin.wlbookings.com (o endereço que o Trafft fornece para contas criadas sob o plano white-label de uma agência), cole o endereço completo, por exemplo, acme.admin.wlbookings.com — isso nos diz onde o seu Trafft está localizado. Digitar apenas acme faria com que a busca fosse feita no endereço padrão do Trafft, que é uma conta diferente.
  2. Preencha seu ID do Cliente e Segredo do Cliente. Ambos estão no seu painel administrativo do Trafft em Recursos e Integrações → API e Conectores.
  3. Opcionalmente, adicione um Rótulo — um nome para sua própria lista, útil se você gerencia vários negócios.
  4. Clique em Conectar.

Verificação de Credenciais

Nada é salvo até que o Trafft confirme. Quando você clica em Connect, nós fazemos login no Trafft com o que você digitou e lemos sua configuração de volta. Um endereço de empresa incorreto, um Client ID ou Secret incorreto, ou um plano do Trafft sem acesso à API é recusado ali mesmo, com o motivo na tela — você nunca termina com uma conexão que parece estar correta e falha na primeira vez que um cliente solicita um agendamento.

Quando funciona, a linha conectada mostra o endereço da sua empresa, juntamente com quantos serviços e quantos membros da equipe encontramos no Trafft. Essa contagem é a sua prova de que a conta correta está conectada: se disser dois serviços e você oferecer vinte, você conectou a conta errada.

Seu Client Secret é armazenado de forma criptografada e nunca mais é exibido — nem para você, nem para sua equipe. Perdeu? Gere um novo no Trafft e conecte novamente.

Pausando ou desconectando

A linha do Trafft conectada possui seus próprios botões na página Booking & Calendar:

  • Atualizar lê novamente as contagens de seus serviços e funcionários do Trafft (veja Adicionando ou Alterando Serviços Posteriormente).
  • Pausar interrompe o agendamento da sua IA no Trafft, mantendo a conexão configurada. Ativar liga-o novamente. Use isso enquanto estiver reorganizando seus serviços ou durante um período de fechamento.
  • Desconectar remove a conexão completamente. Os agendamentos que já estão no Trafft permanecem exatamente como estão — desconectar nunca cancela ou exclui nada no seu calendário do Trafft. Você pode conectar novamente mais tarde com os mesmos detalhes.

Instruindo seu Agente de IA a agendar com o Trafft

Conectar o Trafft ainda não altera o que sua IA faz. Aponte um Agente para ele:

  1. Clique em AI Agents na barra lateral e abra o Agente.
  2. Vá para a etapa AI Abilities e encontre o cartão Bookings.
  3. Ative Let this agent book appointments.
  4. Clique no seletor de provedor e escolha Trafft (as opções de provedor aparecem logo abaixo do interruptor).
  5. Clique em Save changes.

O que a IA pode fazer

Com o Trafft selecionado como provedor, seu Agente pode fazer tudo isso dentro de uma conversa normal:

  • Dizer às pessoas o que você oferece. Ele lista seus serviços do Trafft com a duração e o custo de cada um, e pode citar os membros da sua equipe.
  • Verificar o que está realmente livre. Ele solicita ao Trafft os horários disponíveis para o serviço desejado e pode restringir a um membro específico da equipe ou a um local específico, caso o cliente solicite. Ele verifica até uma semana por vez, então perguntará qual dia ou semana você deseja, em vez de ler todo o seu calendário.
  • Agendar. O agendamento é criado no Trafft na hora, como uma reserva aprovada, e a IA informa ao cliente o horário confirmado. O cliente é adicionado à sua lista de clientes do Trafft ou associado ao registro que já possuem lá através do endereço de e-mail.
  • Consultar o que agendaram. A IA pode informar ao cliente seus próprios agendamentos futuros no Trafft.
  • Cancelar. Uma mensagem (“algo surgiu, você pode cancelar a quinta-feira?”) e o agendamento é removido do seu calendário do Trafft.
  • Mover um agendamento. A IA agenda o novo horário primeiro e só então remove o antigo, para que, caso o novo horário esteja ocupado, o cliente ainda mantenha seu horário original.

Cada agendamento feito dessa forma também aparece na sua página Appointments com o Trafft exibido como provedor, portanto, conta como qualquer outro agendamento: seu webhook de Appointment Booked é disparado, e as automações iniciadas a partir de um novo agendamento são executadas normalmente. Quaisquer lembretes ou e-mails de confirmação que o próprio Trafft envia ainda virão do Trafft, exatamente como ocorrem para um agendamento feito no seu site do Trafft.

Adicionando ou alterando serviços posteriormente

Adicione um serviço no Trafft, altere um preço, desative um ou contrate um novo membro da equipe, e não há nada para ativar aqui. Sua IA lê seu catálogo do Trafft em tempo real, em cada conversa de agendamento, portanto, ela trabalha com base no que o Trafft diz naquele momento, em vez de uma cópia feita quando você se conectou. Um serviço que você adicionou esta manhã pode ser agendado esta tarde.

Duas coisas valem a pena saber:

  • As contagens na linha conectada são de quando você se conectou. Os números de serviços e funcionários exibidos na linha do Trafft na página Agendamento e Calendário são o que encontramos ao verificar suas credenciais, portanto, eles não mudam sozinhos à medida que seu menu do Trafft cresce. Clique em Atualizar nessa linha para lê-los novamente. Isso apenas atualiza esses números — a IA estava lendo seu catálogo em tempo real de qualquer maneira.
  • Se o seu assistente disser que um serviço não existe, peça para ele listar seus serviços. Isso faz com que ele busque o catálogo novamente e responda a partir da lista atualizada. Se o serviço ainda não estiver lá, ele realmente não está na conta do Trafft que você conectou — verifique se você conectou a conta certa (as contagens na linha são o indicador mais rápido).

É bom saber

  • Um cancelamento remove o agendamento no Trafft. A API do Trafft exclui o agendamento em vez de marcá-lo como cancelado, portanto, um agendamento cancelado via chat não deixa uma linha de “cancelado” em seu calendário Trafft. Se você gosta de manter um registro de cancelamentos, anote-os em outro lugar.
  • A IA permanece em seu próprio escopo. Ela apenas vê e altera agendamentos que foram marcados naquela conversa ou que pertencem ao contato com o qual está falando. Ela não pode ler ou mover agendamentos de outras pessoas.
  • Um agendamento precisa de um endereço de e-mail e um nome. O Trafft identifica os clientes por e-mail, então a IA solicita o que ainda estiver faltando antes de realizar o agendamento.
  • Agendamentos em grupo ainda não são suportados. Uma pessoa por agendamento — convidados extras ou tamanhos de grupo não podem ser enviados ao Trafft no momento.
  • Os pagamentos permanecem no Trafft. A IA informa o preço, mas nunca processa um pagamento, e não pode enviar um link de pagamento: a API do Trafft não expõe faturas ou links de pagamento, então não há nada para ela buscar. Se um serviço deve ser pago antecipadamente ou precisa de um depósito, ative um método de pagamento online no Trafft e adicione o placeholder do link de pagamento do Trafft (configurações de notificação por E-mail/SMS → menu suspenso Agendamento) à notificação de Agendamento Aprovado. A confirmação que o Trafft envia após cada agendamento feito pela IA conterá então o link para pagar o valor total ou o depósito. O agendamento em si é criado sem uma etapa de pagamento, portanto, ele é aprovado independentemente de ter sido pago ou não. Quer o link no próprio chat? Adicione seu próprio link de pagamento (Stripe, PayPal, qualquer página de checkout) à base de conhecimento ou instruções do Agente com uma nota sobre quando enviá-lo, e a IA o compartilhará quando um cliente precisar pagar.
  • Uma conta Trafft por conta Your AI Connector. Se você gerencia vários negócios em contas Trafft separadas, conecte aquela na qual seu Agente deve realizar os agendamentos.
  • Contas Trafft white-label funcionam da mesma maneira. Uma conta cujo endereço termina em .admin.wlbookings.com (plano white-label do Trafft) conecta-se exatamente como uma conta padrão — cole o endereço completo como o endereço da empresa. O ID do Cliente e o Segredo do Cliente ainda vêm da própria página Recursos e Integrações → API e Conectores daquela conta, portanto, ela ainda precisa de acesso à API em seu plano Trafft.

Próximos passos

  • AI Agents — configure o Agente que realizará os agendamentos.
  • Booking System — como os agendamentos funcionam em todo o aplicativo e onde eles aparecem.
  • Knowledge Base — adicione seus preços, políticas, estacionamento e regras de cancelamento para que a IA também possa responder sobre o agendamento.