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

::: master-only
<figure><img src="../.gitbook/assets/v2-settings-booking-calendar.png" alt="O ecrã de definições de Booking & Calendar, mostrando os cartões do Google Calendar, Zenchef, Formitable e Trafft, cada um com um botão Connect"><figcaption><p>O Booking &amp; Calendar mostra o estado da ligação em tempo real do Trafft juntamente com o Google Calendar, Zenchef e Formitable, e liga cada um deles.</p></figcaption></figure>
:::

4. Preencha o **Company address**. Esta é a parte antes de `.admin.trafft.com` no endereço em que inicia 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.
5. Preencha o seu **Client ID** e **Client Secret**. Ambos encontram-se no seu painel de administração do Trafft em **Features & Integrations → API & Connectors**.
6. Opcionalmente, adicione um **Label** — um nome para a sua própria lista, útil se gerir 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 Connect Trafft, com campos para Company address, Client ID, Client Secret e um Label opcional"><figcaption><p>Tudo o que a ligação necessita, num único ecrã: o endereço da sua empresa (a parte antes de .admin.trafft.com), o Client ID e o Client Secret da página API &amp; Connectors do Trafft, e uma etiqueta à sua escolha.</p></figcaption></figure>
:::

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

- **Pausar** interrompe as marcações da sua IA no Trafft, mantendo a ligação configurada. **Ativar** volta a ligá-la. Utilize esta opção enquanto reorganiza os seus serviços ou durante um período de encerramento.
- **Desligar** remove a ligação completamente. As marcações que já estão no Trafft permanecem exatamente como estão — desligar nunca cancela nem elimina nada no seu calendário Trafft. Pode ligar novamente 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**.

::: master-only
<figure><img src="../.gitbook/assets/v2-agent-bookings-provider-picker.png" alt="O cartão de Marcações no passo de Capacidades de IA de um Agente de IA com as marcações ativadas e o seletor de fornecedor aberto, mostrando Calendário integrado, Zenchef, Formitable e Trafft"><figcaption><p>O seletor de fornecedor de marcações no cartão de Marcações do agente — escolha Trafft para que este agente faça marcações nos seus serviços, equipa e horários de funcionamento do Trafft.</p></figcaption></figure>
:::

---

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

---

## É bom saber

- **Um cancelamento remove a marcação no Trafft.** A API do Trafft elimina-a em vez de a marcar como cancelada, pelo que uma marcação cancelada a partir de um chat não deixa uma linha de "cancelado" no seu calendário Trafft. Se gosta de manter um registo de cancelamentos, anote-os noutro local.
- **A IA mantém-se no seu âmbito.** Apenas vê e altera marcações que foram feitas nessa conversa ou que pertencem ao contacto com quem está a falar. Não pode ler nem mover marcações de outras pessoas.
- **Uma marcação necessita de um endereço de e-mail e de um nome.** O Trafft identifica os clientes por e-mail, pelo que a IA pedirá 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 marcação — convidados adicionais ou tamanhos de grupo não podem ser enviados para o Trafft de momento.
- **Uma conta Trafft por conta <span data-t="appName">DM Champ</span>.** Se gere vários negócios em contas Trafft separadas, ligue aquela em que o seu Agente deve efetuar as marcações.

---

## Próximos Passos

- [Agentes de IA](../ai-agents/ai-agents.md) — configure o Agente que irá efetuar as marcações.
- [Sistema de Marcações](../appointments/booking-system.md) — como funcionam as marcações em toda a aplicação e onde aparecem.
- [Base de Conhecimento](../ai-automation/faq-management.md) — adicione os seus preços, políticas, estacionamento e regras de cancelamento para que a IA também possa responder sobre as marcações.
