
# 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](connecting-other-tools.md), 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 <span data-t="appName">DM Champ</span> 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 <span data-t="appName">DM Champ</span>, 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**.

::: master-only
<figure><img src="../.gitbook/assets/v2-settings-booking-calendar.png" alt="A tela de configurações de Agendamento e Calendário, mostrando os cartões do Google Calendar, Zenchef, Formitable e Trafft, cada um com um botão Conectar"><figcaption><p>O Agendamento e Calendário mostra o status da conexão ao vivo do Trafft ao lado do Google Calendar, Zenchef e Formitable, e conecta cada um deles.</p></figcaption></figure>
:::

4. Preencha o **Company address**. 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.
5. Preencha seu **Client ID** e **Client Secret**. Ambos estão no seu painel administrativo do Trafft em **Features & Integrations → API & Connectors**.
6. Opcionalmente, adicione um **Label** — um nome para sua própria lista, útil se você gerencia várias empresas.
7. Clique em **Connect**.

::: master-only
<figure><img src="../.gitbook/assets/v2-trafft-connect-modal.png" alt="A caixa de diálogo Conectar Trafft, com campos para endereço da empresa, ID do cliente, Segredo do cliente e um rótulo opcional"><figcaption><p>Tudo o que a conexão precisa, em uma tela: o endereço da sua empresa (a parte antes de .admin.trafft.com), o Client ID e o Client Secret da página API & Connectors do Trafft, e um rótulo de sua escolha.</p></figcaption></figure>
:::

### 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:

- **Pause** interrompe o agendamento da sua IA no Trafft, mantendo a conexão configurada. **Activate** a reativa. Use isso enquanto reorganiza seus serviços ou durante um período de fechamento.
- **Disconnect** 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**.

::: master-only
<figure><img src="../.gitbook/assets/v2-agent-bookings-provider-picker.png" alt="O cartão Bookings na etapa AI Abilities de um Agente de IA com o agendamento ativado e o seletor de provedor aberto, mostrando Built-in calendar, Zenchef, Formitable e Trafft"><figcaption><p>O seletor de provedor de agendamento no cartão Bookings do agente — escolha Trafft para que este agente agende com base nos seus serviços, equipe e horários de funcionamento do Trafft.</p></figcaption></figure>
:::

---

## 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](webhooks.md) 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.

---

## É bom saber

- **Um cancelamento remove o agendamento no Trafft.** A API do Trafft o exclui em vez de marcá-lo como cancelado, portanto, um agendamento cancelado via chat não deixa uma linha de "cancelado" no seu calendário do Trafft. Se você gosta de manter um registro de cancelamentos, anote-os em outro lugar.
- **A IA permanece em seu próprio escopo.** Ela só vê e altera agendamentos que foram feitos 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 clientes por e-mail, então a IA solicitará qualquer informação que ainda esteja faltando antes de agendar.
- **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.
- **Uma conta Trafft por conta <span data-t="appName">DM Champ</span>.** Se você administra várias empresas em contas Trafft separadas, conecte aquela na qual seu Agente deve realizar os agendamentos.

---

## Próximos passos

- [AI Agents](../ai-agents/ai-agents.md) — configure o Agente que realizará os agendamentos.
- [Booking System](../appointments/booking-system.md) — como os agendamentos funcionam em todo o aplicativo e onde eles aparecem.
- [Knowledge Base](../ai-automation/faq-management.md) — adicione seus preços, políticas, estacionamento e regras de cancelamento para que a IA também possa responder sobre o agendamento.
