
# TheFork

> **Para quem é isto?** Esta integração destina-se a restaurantes que aceitam reservas através do TheFork (TheFork Manager). Se não utiliza o TheFork, pode ignorar esta página.
>
> Utiliza um sistema de reservas diferente? Qualquer sistema com uma API pode ser ligado: consulte [Ligar uma Ferramenta que Não Listamos](connecting-other-tools.md), que abrange funções personalizadas, a API e webhooks.

> **Availability.** The TheFork connection is built, but it is not switched on yet. It runs on TheFork's partner API, and TheFork issues those partner credentials only after approving a partnership, so the TheFork card stays hidden until that approval comes through. There is no date to give you yet — if you run your reservations in TheFork and want to know the moment it opens up, send us a note via [email support](mailto:hi@dmchamp.com).

O TheFork é a plataforma de reservas por trás do thefork.com, utilizada por restaurantes em França, Espanha, Itália e outros mercados europeus para reservas online e gestão de mesas. Ligar o TheFork ao <span data-t="appName">DM Champ</span> permite que o seu Agente de IA verifique a disponibilidade real, reserve uma mesa e altere ou cancele uma reserva para um cliente, diretamente no WhatsApp, SMS, Instagram ou chat do site onde o cliente já se encontra.

---

## O que a IA pode fazer com o TheFork

Uma vez ligado e selecionado como fornecedor de reservas num Agente de IA, o Agente pode:

- **Verificar horários disponíveis** para uma data e número de pessoas de acordo com a disponibilidade em tempo real do restaurante no TheFork, e pesquisar num intervalo de datas para informar o cliente sobre os dias em que ainda existem mesas.
- **Indicar o custo de um horário antes de reservar.** Se um horário exigir uma garantia com cartão de crédito, ou se apenas puder ser reservado em conjunto com uma oferta ou menu específico, o Agente informará o cliente em vez de reservar algo diferente sem aviso.
- **Reservar a mesa** com o nome do cliente, e-mail, número de pessoas, data, hora e qualquer pedido especial que mencionem.
- **Encontrar as próximas reservas do cliente** para que possa consultar ou gerir uma delas. No WhatsApp e SMS, a pesquisa é feita pelo número de telefone da conversa; noutros canais, apenas tem conhecimento das reservas efetuadas nessa mesma conversa.
- **Alterar** a data, a hora ou o número de pessoas de uma reserva.
- **Cancelar** uma reserva.

A sua equipa vê cada uma destas reservas no TheFork Manager como qualquer outra reserva, listada com **TheFork Manager API** como o canal de origem.

### É bom saber

- **Algumas reservas são efetuadas "sob pedido".** O restaurante confirma essas reservas posteriormente, em vez de a mesa ser reservada de imediato, e o Agente informa o cliente exatamente disso, em vez de prometer uma mesa confirmada.
- **Horários que exigem um depósito ou uma pré-autorização de cartão não podem ser reservados no chat.** O Agente explica o motivo e encaminha o cliente para si ou para a sua página do TheFork para concluir o processo.
- **Apenas reservas, não o menu.** Consulte [Questões sobre o Menu](#menu-questions) abaixo.

---

## Onde aparecem as reservas

Todas as reservas efetuadas pelo Agente também aparecem na sua página de **Marcações** com um emblema THEFORK, para que as veja ao lado das suas outras reservas.

O TheFork continua a ser o sistema de registo para o cliente: o TheFork envia o seu próprio e-mail de confirmação, pelo que o <span data-t="appName">DM Champ</span> não envia um segundo e-mail, e estas reservas não são copiadas para o Google Calendar. O calendário do seu restaurante é o TheFork Manager.

---

## Ligar o TheFork

> **Antes de começar:** o seu restaurante precisa de ter o parceiro <span data-t="appName">DM Champ</span> ativado na sua conta TheFork. Isto é algo que o TheFork ativa para o restaurante; solicite-o ao seu gestor de conta TheFork ou ao apoio ao cliente do TheFork. Até que isto seja feito, o TheFork não nos permite aceder ao restaurante e o passo do ID do Restaurante abaixo terminará com uma mensagem a indicar isso mesmo.

1. Na barra lateral esquerda, clique em **Definições** (ícone de engrenagem).
2. Na barra lateral de Definições, no grupo **Integrações**, clique em **Reservas e Calendário**.
3. Encontre o cartão **TheFork** e clique em **Adicionar restaurante**.
4. Cole o seu **ID de Restaurante** e clique em **Verificar**. Este é o identificador longo que o TheFork atribui ao seu restaurante (um UUID, uma sequência de letras, números e travessões); encontrará este ID no TheFork Manager ou pode solicitá-lo ao apoio ao cliente do TheFork. Verificamos se o restaurante está acessível antes de prosseguir.
5. Atribua um **nome** ao restaurante (é o que verá na lista e como a IA se referirá a ele) e guarde.

Pode adicionar vários restaurantes desta forma, um por cada ID de Restaurante TheFork: clique em **Adicionar restaurante** na linha do TheFork ligada para cada um. A IA fará reservas no restaurante ativo; coloque os outros em pausa.

### Pausar ou Remover um Restaurante

Cada restaurante ligado tem os seus próprios botões **Pausar** e **Remover** na página de Reservas e Calendário. Pausar impede que a IA aceite reservas para esse restaurante, mantendo a configuração; remover elimina-o completamente, embora possa adicioná-lo novamente a qualquer momento com o mesmo ID.

---

## Dizer ao seu Agente de IA para efetuar reservas com o TheFork

1. Clique em **Agentes de IA** na barra lateral e abra o Agente.
2. Aceda ao passo **Capacidades da IA** e encontre o cartão **Reservas**.
3. Ative a opção **Permitir que este agente marque compromissos**.
4. Clique no seletor de fornecedor, escolha **TheFork** e selecione para qual dos seus restaurantes ligados este Agente efetuará reservas.

Não é necessário nenhum tipo de evento: o TheFork traz a sua própria disponibilidade, horário de funcionamento e plano de mesas.

---

## Como decorre uma conversa de reserva

1. O cliente pede uma mesa. O Agente solicita a data e o número de pessoas, bem como uma hora preferencial, caso a tenham.
2. O Agente verifica o TheFork e informa o cliente sobre o que está disponível para reserva. Se não houver disponibilidade nesse dia, pode indicar que dias próximos ainda têm mesas. Se a hora pretendida exigir uma garantia com cartão de crédito, ou pertencer a uma oferta ou menu específico, o Agente informará antes de efetuar a reserva.
3. O cliente escolhe uma hora e fornece o nome e o e-mail. O Agente reserva a mesa e confirma-a, ou explica que o restaurante ainda tem de a confirmar quando o TheFork devolver a reserva como um pedido.
4. Mais tarde, o cliente pode pedir ao mesmo Agente para alterar o dia, a hora ou o número de pessoas, ou para cancelar.

Os horários são sempre a hora local do restaurante.

---

## Perguntas sobre o Menu

A ligação ao TheFork cobre as reservas; não lê o seu menu. Para permitir que a IA responda a perguntas sobre o menu:

- **Adicione o menu à base de conhecimento:** coloque os seus pratos, preços, notas sobre alergénios e pratos do dia nas FAQs ou fontes de conhecimento do seu Agente de IA, e o bot responderá a "Que opções vegetarianas têm?" a partir daí — consulte [Gerir FAQs](../ai-automation/faq-management.md).
- **Envie o menu como ficheiro:** carregue o PDF ou a imagem do menu para a biblioteca de multimédia com uma nota sobre "quando enviar", e o bot enviá-lo-á quando um cliente pedir o menu ou a lista de preços.

---

## Dicas para Restaurantes

- **Preencha o seu número de telefone e website** na sua conta e no restaurante, para que, quando a IA tiver de encaminhar um cliente (um horário que exija um depósito, uma alteração que o restaurante tenha de fazer), lhe forneça uma forma real de o contactar.
- **Adicione FAQs operacionais** à base de conhecimentos do seu Agente de IA: horários, estacionamento, refeições privadas, políticas de alergénios, código de vestuário — consulte [Gerir FAQs](../ai-automation/faq-management.md).
- **Utilize etiquetas** para segmentar a sua lista de clientes — por exemplo, "apreciador-de-vinho", "celebração-de-aniversário", "grupo-grande" — e envie comunicações direcionadas para cada segmento.

---

## Próximos Passos

- [AI Agents](../ai-agents/ai-agents.md) — configure o Agente de IA do seu restaurante.
- [Sistema de Reservas](../appointments/booking-system.md) — como funcionam as reservas entre fornecedores.
- [Gerir FAQs](../ai-automation/faq-management.md) — adicione perguntas e respostas específicas do restaurante.
