
# TheFork

> **Para quem é isto?** Esta integração é para restaurantes que aceitam reservas através do TheFork (TheFork Manager). Se você não usa o TheFork, pode pular esta página.
>
> Usa um sistema de reservas 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.

> **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, usada por restaurantes em toda a França, Espanha, Itália e outros mercados europeus para reservas online e gestão de mesas. Conectar o TheFork ao <span data-t="appName">DM Champ</span> permite que seu Agente de IA verifique a disponibilidade real, reserve uma mesa e altere ou cancele uma reserva para um cliente, diretamente dentro do WhatsApp, SMS, Instagram ou chat do site em que o cliente já está.

---

## O que a IA pode fazer com o TheFork

Uma vez conectado e escolhido como o provedor de reservas em um Agente de IA, o Agente pode:

- **Verificar horários disponíveis** para uma data e tamanho de grupo em relação à disponibilidade em tempo real do restaurante no TheFork, e pesquisar em uma variedade de datas para informar ao cliente quais dias ainda possuem mesas.
- **Indicar o custo de um horário antes de reservá-lo.** Se um horário exigir garantia com cartão de crédito, ou se só puder ser reservado junto com uma oferta específica ou menu fixo, o Agente informará isso em vez de reservar outra coisa silenciosamente.
- **Reservar a mesa** com o nome do cliente, e-mail, tamanho do grupo, data, horário e qualquer pedido especial que ele mencionar.
- **Encontrar as próximas reservas do próprio cliente** para que possa informar ou agir sobre uma delas. No WhatsApp e SMS, ele as localiza pelo número de telefone da conversa; em outros canais, ele só conhece as reservas feitas naquele mesmo chat.
- **Alterar** a data, o horário ou o tamanho do grupo de uma reserva.
- **Cancelar** uma reserva.

Sua equipe vê cada uma delas no TheFork Manager como qualquer outra reserva, listada com **TheFork Manager API** como o canal de origem.

### É bom saber

- **Algumas reservas retornam como "sob pedido".** O restaurante confirma essas posteriormente em vez de a mesa ser reservada imediatamente, e o Agente informa exatamente isso ao cliente em vez de prometer uma mesa confirmada.
- **Horários que exigem depósito ou impressão de cartão não podem ser reservados no chat.** O Agente explica o motivo e direciona o cliente para você ou para sua página do TheFork para finalizar o processo lá.
- **Apenas reservas, não o menu.** Veja [Perguntas sobre o Menu](#menu-questions) abaixo.

---

## Onde as reservas aparecem

Cada reserva que o Agente faz também aparece na sua página de **Agendamentos** com um selo THEFORK, para que você a veja ao lado das suas outras reservas.

O TheFork permanece como o sistema de registro para o cliente: o TheFork envia seu próprio e-mail de confirmação, portanto o <span data-t="appName">DM Champ</span> não envia um segundo, e essas reservas não são copiadas para o Google Calendar. O calendário do seu restaurante é o TheFork Manager.

---

## Conectando o TheFork

> **Antes de começar:** seu restaurante precisa ter o parceiro <span data-t="appName">DM Champ</span> habilitado em sua conta do TheFork. Isso é algo que o TheFork ativa para o restaurante; peça ao seu gerente de conta do TheFork ou ao suporte do TheFork. Até que isso seja feito, o TheFork não nos permite acessar o restaurante e a etapa de ID do Restaurante abaixo será interrompida com uma mensagem informando isso.

1. Na barra lateral esquerda, clique em **Configurações** (ícone de engrenagem).
2. Na barra lateral de Configurações, sob o grupo **Integrações**, clique em **Agendamento e Calendário**.
3. Encontre o cartão **TheFork** e clique em **Adicionar restaurante**.
4. Cole seu **ID do Restaurante** e clique em **Verificar**. Este é o identificador longo que o TheFork fornece ao seu restaurante (um UUID, uma sequência de letras, números e traços); você o encontrará no TheFork Manager ou pode solicitá-lo ao suporte do TheFork. Verificamos se o restaurante está acessível antes de prosseguir.
5. Dê um **nome** ao restaurante (é isso que você verá na lista e como a IA o chamará) e salve.

Você pode adicionar vários restaurantes desta forma, um por ID de Restaurante do TheFork: clique em **Adicionar restaurante** na linha do TheFork conectada para cada um. A IA fará reservas no que estiver ativo; pause os outros.

### Pausando ou Removendo um Restaurante

Cada restaurante conectado possui seus próprios botões **Pausar** e **Remover** na página de Reservas e Calendário. Pausar impede que a IA aceite reservas para aquele restaurante, mantendo-o configurado; remover exclui o restaurante completamente, embora você possa adicioná-lo novamente a qualquer momento com o mesmo ID.

---

## Instruindo seu Agente de IA a fazer reservas com o TheFork

1. Clique em **Agentes de IA** na barra lateral e abra o Agente.
2. Vá para a etapa **Habilidades de IA** e encontre o cartão **Reservas**.
3. Ative **Permitir que este agente agende compromissos**.
4. Clique no seletor de provedor, escolha **TheFork** e selecione para qual dos seus restaurantes conectados este Agente fará reservas.

Nenhum tipo de evento é necessário: o TheFork traz sua própria disponibilidade, horários de funcionamento e plano de mesas.

---

## Como funciona uma conversa de reserva

1. O convidado solicita uma mesa. O Agente pergunta a data e o número de convidados, além de um horário preferencial, caso tenham um.
2. O Agente verifica o TheFork e informa ao convidado o que está disponível para reserva. Se nada estiver disponível naquele dia, ele pode informar quais dias próximos ainda possuem mesas. Se o horário desejado exigir garantia com cartão de crédito, ou pertencer a uma oferta específica ou menu fixo, o Agente informará antes de reservar.
3. O convidado escolhe um horário e fornece seu nome e e-mail. O Agente reserva a mesa e confirma, ou explica que o restaurante ainda precisa confirmar quando o TheFork retornar a reserva como uma solicitação.
4. Posteriormente, o convidado pode pedir ao mesmo Agente para alterar o dia, o horário ou o número de pessoas, ou para cancelar.

Os horários são sempre no horário local do restaurante.

---

## Perguntas sobre o Menu

A conexão com o TheFork cobre reservas; ela não lê seu menu. Para permitir que a IA responda a perguntas sobre o menu:

- **Adicione o menu à base de conhecimento:** coloque seus pratos, preços, notas sobre alérgenos e pratos do dia nas FAQs ou fontes de conhecimento do seu Agente de IA, e o bot responderá "Quais opções vegetarianas vocês têm?" a partir daí — veja [Gerenciando FAQs](../ai-automation/faq-management.md).
- **Envie o menu como um arquivo:** faça o upload do PDF ou imagem do menu para a biblioteca de mídia com uma nota de "quando enviar", e o bot o enviará quando um cliente solicitar o menu ou a lista de preços.

---

## Dicas para Restaurantes

- **Preencha seu número de telefone e site** em sua conta e no restaurante, para que, quando a IA precisar transferir um convidado (um horário que exija depósito, uma alteração que o restaurante precise fazer), ela forneça uma forma real de entrar em contato com você.
- **Adicione FAQs operacionais** à base de conhecimento do seu Agente de IA: horários, estacionamento, refeições privativas, políticas de alérgenos, código de vestimenta — veja [Gerenciando FAQs](../ai-automation/faq-management.md).
- **Use tags** para segmentar sua lista de convidados — por exemplo, "apreciador de vinhos", "comemoração de aniversário", "grande grupo" — e envie comunicados direcionados para cada segmento.

---

## Próximos passos

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