Your AI Connector Docs

Trafft

Para quem é isto? Esta integração destina-se a empresas de marcações que já gerem a sua agenda no Trafft — salões, barbearias, clínicas, estúdios, consultores, oficinas de reparação. Se não utiliza o Trafft, pode ignorar esta página.

Utiliza um sistema de agendamento diferente? Qualquer ferramenta com uma API pode ser ligada: consulte Ligar uma Ferramenta que Não Listamos, que aborda funções personalizadas, a API e webhooks.

O Trafft é uma plataforma de agendamento para empresas que vendem tempo: define os seus serviços, o seu pessoal e as suas localizações, e os clientes marcam um horário. Ligar o Trafft ao Your AI Connector permite que o seu Agente de IA trate de toda a marcação dentro do chat — verificando o que está realmente livre, reservando o horário e confirmando-o — em vez de enviar alguém para um link de marcação e esperar que concluam o processo.


O que o Trafft faz

O Trafft oferece a uma empresa de marcações:

  • Serviços com a sua própria duração e preço
  • Pessoal (funcionários) com os seus próprios horários de trabalho
  • Uma ou mais localizações
  • Um site de marcações e calendário para a sua equipa

Ao ligar o Trafft ao Your AI Connector, essa mesma agenda torna-se algo com que a sua IA pode trabalhar no WhatsApp, SMS, Instagram ou no chat do seu site. A IA lê os seus serviços e pessoal, verifica no Trafft as disponibilidades reais e regista a marcação diretamente no Trafft — para que o que a sua equipa vê no Trafft seja sempre a realidade.


Ligar o Trafft

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

  1. Na barra lateral esquerda, clique em Settings (ícone de engrenagem).
  2. Na barra lateral de Definições, sob o grupo Integrations, clique em Booking & Calendar.
  3. Encontre o cartão Trafft e clique em Connect.
  1. Preencha a Morada da empresa. Esta é a parte antes de .admin.trafft.com no endereço que utiliza para iniciar sessão — se inicia sessão em acme.admin.trafft.com, escreva acme. Colar o endereço completo também funciona; nós extraímos a parte correta. Conta Trafft com marca branca (white-label)? Se o seu endereço Trafft terminar em .admin.wlbookings.com (o endereço que a Trafft atribui a contas criadas ao abrigo do plano de marca branca de uma agência), cole o endereço completo, por exemplo acme.admin.wlbookings.com — isso indica-nos onde reside a sua conta Trafft. Escrever apenas acme faria com que a procura fosse feita no endereço padrão da Trafft, que é uma conta diferente.
  2. Preencha o seu ID de Cliente e Segredo de Cliente. Ambos encontram-se no seu painel de administração Trafft em Funcionalidades e Integrações → API e Conectores.
  3. Opcionalmente, adicione uma Etiqueta — um nome para a sua própria lista, útil se gerir vários negócios.
  4. Clique em Ligar.

Verificação de Credenciais

Nada é guardado até que o Trafft o confirme. Quando clica em Connect, iniciamos sessão no Trafft com o que escreveu e lemos a sua configuração. Um endereço de empresa incorreto, um Client ID ou Secret incorreto, ou um plano Trafft sem acesso à API é recusado imediatamente, com o motivo apresentado no ecrã — nunca acabará com uma ligação que parece correta e falha na primeira vez que um cliente pede uma marcação.

Quando funciona, a linha ligada mostra o endereço da sua empresa juntamente com quantos serviços e quantos membros da equipa encontrámos no Trafft. Essa contagem é a sua prova de que a conta correta está ligada: se diz dois serviços e oferece vinte, ligou a conta errada.

O seu Client Secret é armazenado de forma encriptada e nunca mais é mostrado — nem a si, nem à sua equipa. Perdeu-o? Gere um novo no Trafft e ligue novamente.

Pausar ou desligar

A linha do Trafft ligada tem os seus próprios botões na página de Marcações e Calendário:

  • Atualizar lê novamente as contagens dos seus serviços e funcionários a partir do Trafft (consulte Adicionar ou Alterar Serviços Mais Tarde).
  • Pausar interrompe as marcações da sua IA no Trafft, mantendo a ligação configurada. Ativar volta a ligá-las. Utilize esta opção enquanto reorganiza os seus serviços ou durante um período de encerramento.
  • Desligar remove a ligação completamente. Os agendamentos que já se encontram no Trafft permanecem exatamente como estão — desligar nunca cancela nem elimina nada no seu calendário Trafft. Pode voltar a ligar mais tarde com os mesmos detalhes.

Dizer ao seu Agente de IA para marcar com o Trafft

Ligar o Trafft ainda não altera o que a sua IA faz. Aponte um Agente para o mesmo:

  1. Clique em Agentes de IA na barra lateral e abra o Agente.
  2. Vá ao passo Capacidades de IA e encontre o cartão Marcações.
  3. Ative Permitir que este agente marque agendamentos.
  4. Clique no seletor de fornecedor e escolha Trafft (as opções de fornecedor aparecem logo abaixo do interruptor).
  5. Clique em Guardar alterações.

O que a IA pode fazer

Com o Trafft selecionado como fornecedor, o seu Agente pode fazer tudo isto durante uma conversa normal:

  • Dizer às pessoas o que oferece. Lista os seus serviços Trafft com a duração e o custo de cada um, e pode nomear os membros da sua equipa.
  • Verificar o que está realmente livre. Pergunta ao Trafft pelos horários disponíveis para o serviço que alguém pretende, podendo restringir a um membro específico da equipa ou a um local específico, se o cliente o solicitar. Analisa até uma semana de cada vez, pelo que perguntará a que dia ou semana se refere, em vez de ler todo o seu calendário.
  • Marcar. O agendamento é criado no Trafft no momento, como uma marcação aprovada, e a IA comunica ao cliente a hora confirmada. O cliente é adicionado à sua lista de clientes Trafft ou associado ao registo que já lá possui através do seu endereço de e-mail.
  • Consultar o que marcaram. A IA pode informar um cliente sobre as suas próximas marcações no Trafft.
  • Cancelar. Uma mensagem (“surgiu um imprevisto, pode cancelar a quinta-feira?”) e a marcação desaparece do seu calendário Trafft.
  • Mover uma marcação. A IA marca primeiro a nova hora e só depois remove a antiga, para que, caso a nova hora já esteja ocupada, o cliente mantenha o seu espaço original.

Cada marcação feita desta forma também aparece na sua página de Marcações com o Trafft indicado como fornecedor, pelo que conta como qualquer outra marcação: o seu webhook de Marcação Efetuada é acionado e as automatizações iniciadas por uma nova marcação são executadas normalmente. Quaisquer lembretes ou e-mails de confirmação que o próprio Trafft envie continuam a vir do Trafft, exatamente como acontece para uma marcação feita no seu site Trafft.


Adicionar ou alterar serviços mais tarde

Adicione um serviço no Trafft, altere um preço, retire um serviço ou aceite um novo membro da equipa, e não há nada para ativar aqui. A sua IA lê o seu catálogo Trafft em tempo real, em cada conversa de marcação, pelo que funciona com base no que o Trafft indica nesse momento, em vez de uma cópia feita quando se ligou. Um serviço que adicionou esta manhã pode ser marcado esta tarde.

Vale a pena saber duas coisas:

  • As contagens na linha ligada referem-se ao momento em que se ligou. Os números de serviços e de pessoal apresentados na linha do Trafft na página Marcações e Calendário são os que encontrámos ao verificar as suas credenciais, pelo que não mudam por si só à medida que o seu menu Trafft aumenta. Clique em Atualizar nessa linha para os ler novamente. Isto apenas atualiza esses números — a IA estava a ler o seu catálogo em tempo real de qualquer forma.
  • Se o seu assistente disser alguma vez que um serviço não existe, peça-lhe para listar os seus serviços. Isso faz com que ele procure o catálogo novamente e responda a partir da lista atualizada. Se o serviço continuar a não aparecer, é porque realmente não está na conta Trafft que ligou — verifique se ligou a conta correta (as contagens na linha são o indicador mais rápido).

É bom saber

  • Um cancelamento remove o agendamento no Trafft. A API do Trafft elimina-o em vez de o marcar como cancelado, pelo que uma marcação cancelada a partir de uma conversa não deixa qualquer registo de “cancelado” no seu calendário Trafft. Se gosta de manter um registo dos cancelamentos, anote-os noutro local.
  • A IA mantém-se no seu âmbito. Apenas vê e altera agendamentos que foram marcados nessa conversa, ou que pertencem ao contacto com quem está a falar. Não consegue ler ou mover as marcações de mais ninguém.
  • Uma marcação necessita de um endereço de e-mail e de um nome. O Trafft identifica os clientes pelo e-mail, pelo que a IA solicita o que ainda estiver em falta antes de efetuar a marcação.
  • As marcações de grupo ainda não são suportadas. Uma pessoa por agendamento — convidados extra ou dimensões de grupo não podem ser enviados para o Trafft de momento.
  • Os pagamentos permanecem no Trafft. A IA indica o preço, mas nunca efetua um pagamento, e não pode enviar um link de pagamento: a API do Trafft não expõe faturas ou links de pagamento, pelo que não há nada para a IA obter. Se um serviço tiver de ser pago antecipadamente ou necessitar de um depósito, ative um método de pagamento online no Trafft e adicione o marcador de link de pagamento do Trafft (definições de notificação de E-mail/SMS → menu pendente Agendamento) à notificação de Agendamento Aprovado. A confirmação que o Trafft envia após cada marcação efetuada pela IA conterá então o link para pagar o valor total ou o depósito. A marcação em si é criada sem um passo de pagamento, pelo que é aprovada independentemente de ter sido paga ou não. Pretende o link na própria conversa? Adicione o seu próprio link de pagamento (Stripe, PayPal, qualquer página de checkout) à base de conhecimentos ou instruções do Agente com uma nota sobre quando o enviar, e a IA partilhá-lo-á quando um cliente precisar de pagar.
  • Uma conta Trafft por conta Your AI Connector. Se gere vários negócios em contas Trafft separadas, ligue aquela em que o seu Agente deve efetuar as marcações.
  • As contas Trafft white-label funcionam da mesma forma. Uma conta cujo endereço termina em .admin.wlbookings.com (plano white-label do Trafft) liga-se exatamente como uma conta padrão — cole o endereço completo como endereço da empresa. O ID do Cliente e o Segredo do Cliente continuam a provir da página Funcionalidades e Integrações → API e Conectores dessa conta, pelo que continua a necessitar de acesso à API no seu plano Trafft.

Próximos Passos

  • Agentes de IA — configure o Agente que irá efetuar as marcações.
  • Sistema de Marcações — como funcionam as marcações em toda a aplicação e onde aparecem.
  • Base de Conhecimento — adicione os seus preços, políticas, estacionamento e regras de cancelamento para que a IA também possa responder sobre as marcações.