Integração · Agendamento

Conecte Claude e ChatGPT ao Yoplanning

Pergunte à sua IA sobre quem trabalha no sábado, quais os horários livres para um produto ou reserve um cliente no Yoplanning. Ela pode pesquisar e criar clientes, criar e atualizar pedidos, ler sessões e movê-las, listar pagamentos e bloquear horário quando um membro da equipa não estiver disponível. Perguntas de planeamento são respondidas sem abrir o calendário.

Ligar Yoplanning gratuitamente

Plano gratuito, sem cartão de crédito. Demora cerca de um minuto.

Experimente pedir

“Quem trabalha no sábado?”
A IA lista as atribuições de pessoal às sessões nesse intervalo de datas, para que veja quem trabalha quando.
“Quais os horários ainda livres para a excursão em caiaque na próxima semana?”
Ela encontra o produto online e lista os seus próximos horários disponíveis.
“Reserve Lea Martin para dois lugares na sessão de escalada do sábado.”
Ela pesquisa o cliente primeiro, cria-o se for novo e cria o pedido com os itens e status da reserva.

O que a sua IA pode fazer

Sessões e pessoal

Ler e atualizar sessões, ver atribuições de pessoal, listar membros da equipa e criar ou listar indisponibilidades de pessoal.

Reservas e pagamentos

Listar, ler, criar e atualizar pedidos, listar pagamentos e ver horários disponíveis para produtos online.

Clientes e produtos

Pesquisar, criar e atualizar clientes e listar produtos, produtos online e recursos como preços, aluguer e opções.

“O pedido 7f3c… foi pago?”
Ela lê o pedido e lista os pagamentos nele registados.
“Mova a sessão das 10:00 de amanhã para as 14:00.”
Ela atualiza a sessão com o novo início e fim.
“Marque Thomas como indisponível do dia 3 ao dia 7 de março, motivo férias.”
Ela cria uma indisponibilidade para esse membro da equipa com datas e motivo.

68 ferramentas para Yoplanning

Estas ferramentas são ativadas quando estabelece a ligação. Pode desativar qualquer uma delas ou exigir a sua aprovação antes de ser executada.

create_customerAltera dadosCrie um cliente. Passe um novo UUID como `id` junto com primeiro/último nome, email, telefone, endereço, idioma e nota.
create_orderAltera dadosCrie um pedido (reserva). Passe um novo UUID como `id`, o `main_client`, `items`, `currency` e opcionais `note` e `booking_status`.
create_order_paymentAltera dadosCrie um novo pagamento para um pedido. Obrigatório: id, cliente ou valor.
create_teamAltera dadosCriar uma nova equipe.
create_team_order_validationAltera dadosCrie uma nova validação de pedido para uma equipe.
create_team_productAltera dadosCrie um novo produto para uma equipe. Obrigatório: corpo.
create_team_resourceAltera dadosCrie um novo recurso para uma equipe. Obrigatório: id ou preço.
create_team_session_groupAltera dadosCrie um novo grupo de sessões para uma equipe. Obrigatório: id ou sessões.
create_team_use_discountAltera dadosCrie um novo uso de desconto para uma equipe.
create_team_userAltera dadosCrie um novo usuário para uma equipe. Obrigatório: pessoa.
create_team_webhook_subscriberElimina dadosCrie um novo assinante de webhook para uma equipe. Obrigatório: id ou url. Ação destrutiva; pode exigir aprovação.
create_unavailabilityAltera dadosBloqueie tempo para um membro do pessoal. Passe um novo UUID como `id`, `teacher_id`, `start_date`, `end_date` e opcionais `reason`.
delete_team_orderElimina dadosExcluir permanentemente um pedido por ID de pedido. Ação destrutiva; pode exigir aprovação.
delete_team_webhook_subscriberElimina dadosDele permanentemente um assinante de webhook pelo ID do assinante de webhook. Ação destrutiva; pode exigir aprovação.
get_categoryRetorna uma categoria pelo id de categoria.
get_customerObter um cliente pelo `customer_id`.
get_orderObtenha um pedido pelo `order_id`, com itens, cliente e status de pagamento.
get_order_paymentObtenha um pagamento para um pedido pelo ID de pagamento.
get_productObtenha um produto pelo `product_id`, com preço, duração e descrições.
get_sessionObtenha uma sessão (um slot de atividade agendado) pelo `session_id`, com pessoal, clientes e horários.
get_teamObtenha os detalhes da sua equipe Yoplanning.
get_team_attendanceObtenha uma presença para uma equipe pelo ID de presença.
get_team_auth_tokenObtenha um token de autenticação para uma equipe pela chave do token de autenticação.
get_team_availability_detailObtenha um detalhe de disponibilidade para uma equipe pelo ID do detalhe de disponibilidade.
get_team_employeeObtenha um funcionário para uma equipe pelo ID do funcionário.
get_team_online_resourceObtenha um recurso online para uma equipe pelo ID do recurso online.
get_team_paymentObtenha um pagamento para uma equipe pelo ID de pagamento.
get_team_productObtenha um produto para uma equipe pelo ID do produto.
get_team_providerObtenha um fornecedor para uma equipe pelo ID do fornecedor.
get_team_resourceObtenha um recurso para uma equipe pelo ID do recurso.
get_team_session_groupObtenha um grupo de sessões para uma equipe pelo ID do grupo de sessões.
get_team_unavailabilityObtenha uma indisponibilidade para uma equipe pelo ID da indisponibilidade.
get_team_userObtenha um usuário para uma equipe pelo ID do usuário.
get_team_webhook_subscriberObtenha um assinante de webhook para uma equipe pelo ID do assinante de webhook.
get_ticketObtenha um ticket pelo ID do pedido.
get_ticket_validate_ticket_readObtenha um ticket pelo ID de conteúdo do pedido.
list_categoriesListe categorias. Filtros opcionais: ordenação. Os resultados são paginados.
list_membersListar los miembros de su equipo (personal).
list_online_productsListar los productos vendidos en línea a través de sus motores de reserva.
list_order_paymentsListe pagamentos registrados em um pedido pelo `order_id`.
list_ordersListar pedidos (reservas), filtrado por fecha de creación o rango de última actualización.
list_paymentsListar pagos, filtrado por `status`, `client_id`, `customer_order_id`, nombre del cliente, monto o fecha de creación.
list_product_availabilitiesListe os slots disponíveis futuros para um produto online pelo `product_id`.
list_productsListar las actividades/productos que su equipo ofrece.
list_provider_booking_enginesListar motores de reserva para un proveedor. Filtros opcionales: ordenación. Los resultados están paginados.
list_resourcesListar recursos (precios, alquileres, opciones), buscables por `name_contains`, `label_contains` o precio.
list_session_groupsListar grupos de sesiones. Los resultados están paginados.
list_staff_attendancesListar asignaciones de personal a sesiones, filtrado por `teacher_id`, nombre del profesor, estado del personal o rango `start_date`. Útil para ver quién trabaja cuándo.
list_team_auth_tokensListar tokens de autenticación para un equipo. Los resultados están paginados.
list_team_booking_enginesListar motores de reserva para un equipo. Filtros opcionales: ordenación. Los resultados están paginados.
list_team_employeesListar empleados de un equipo. Filtros opcionales: última actualización, última actualización mayor que, última actualización menor que, fecha de creación, fecha de creación mayor que o fecha de creación menor que. Los resultados están paginados.
list_team_online_resourcesListar recursos en línea para un equipo. Filtros opcionales: ID del equipo 2. Los resultados están paginados.
list_team_providersListar proveedores para un equipo. Los resultados están paginados.
list_team_resellersListar revendedores para un equipo. Los resultados están paginados.
list_team_webhook_subscribersListar suscriptores de webhooks para un equipo.
list_teamsListar equipos. Filtros opcionales: ordenación. Los resultados están paginados.
list_unavailabilitiesListar indisponibilidades de personal, filtrado por `staff` y rangos de fechas inicio/fin.
search_customersBuscar clientes por `first_name`, `last_name`, `email`, `phone_number`, `city` o fecha de última actualización. Use antes de crear para evitar duplicados.
update_customerAltera dadosActualizar un cliente mediante `customer_id` (también pase el mismo valor como `id`). Envíe el registro completo del cliente; los campos omitidos pueden ser borrados.
update_orderAltera dadosActualizar un pedido mediante `order_id` (también pase el mismo valor como `id`), ej. sus artículos, nota o estado de reserva.
update_sessionAltera dadosActualizar una sesión mediante `session_id` (también pásela como `id`) con `start_date` y `end_date`, además de nombre, personal, clientes, participantes máximos o punto de encuentro.
update_teamAltera dadosAtualizar uma equipa existente identificada pelo ID da equipa.
update_team_productAltera dadosAtualiza um produto existente identificado pelo ID do produto.
update_team_resourceAltera dadosActualizar un recurso existente identificado por su ID de recurso.
update_team_session_groupAltera dadosActualizar un grupo de sesiones existente identificado por su ID de grupo de sesión.
update_team_unavailabilityAltera dadosActualizar una indisponibilidad existente identificada por su ID de indisponibilidad.
update_team_userAltera dadosAtualiza um usuário existente identificado pelo ID do usuário.
update_team_webhook_subscriberElimina dadosActualizar un suscriptor de webhook existente identificado por su ID de suscriptor de webhook. Acción destructiva; puede requerir aprobación.

Configure em três passos

1
Escolha a aplicação
Crie uma conta gratuita no PipMCP e escolha Yoplanning na lista de aplicações.
2
Cole a sua chave
Cole o seu token de API do Yoplanning e a sua equipa ID. No Yoplanning, abra as preferências, vá à secção 'API YoPlanning' e solicite um token de API. O ID da equipa é necessário porque a maioria das chamadas funciona numa única equipa.
3
Adicione a ligação à sua IA
Receberá uma ligação MCP pessoal. Adicione-a ao Claude, ao ChatGPT ou ao Cursor:
1. Clique no seu nome e depois em Definições › Conectores › Adicionar conector personalizado.
2. Cole a sua ligação no campo URL do servidor MCP remoto.
3. Ative-o no menu + de uma conversa.

Perguntas

O que a IA pode fazer no Yoplanning?

Ela pode ler a sua equipa, sessões, pedidos, clientes, produtos, produtos online e os seus horários disponíveis, recursos, pagamentos, membros da equipa, atribuições de pessoal e indisponibilidades. Ela pode criar clientes, pedidos e indisponibilidades de pessoal, e atualizar clientes, pedidos e sessões.

A IA vê o meu token de API do Yoplanning?

Não. Seu token de API está criptografado em repouso e nunca é exibido à IA. Após salvar, ele não aparece novamente, nem mesmo para você. A IA vê apenas os resultados das ferramentas que chama.

Posso controlar o que a IA é autorizada a fazer?

Sim. Você escolhe quais ferramentas estão ativadas, para que possa começar apenas leitura. Criar pedidos e alterar sessões afetam o seu planeamento e podem exigir a sua aprovação antes de serem executados. Todas as chamadas de ferramenta são registadas.

Funciona com o ChatGPT?

Sim. No ChatGPT, vá em Configurações › Aplicações e Conectores › Avançado, ative o Modo Desenvolvedor e adicione seu link do PipMCP. O Modo Desenvolvedor requer um plano pago do ChatGPT: Plus, Pro, Business ou Enterprise. O mesmo link funciona no Claude (Configurações › Conectores › Adicionar conector personalizado), Cursor e outros clientes MCP.

Qual é o custo?

O PipMCP tem um plano gratuito e não precisa de cartão de crédito para começar. Os planos pagos são cobrados por tarefa concluída. Também precisa da sua própria conta do Yoplanning.

Por que o Yoplanning precisa de um ID de equipa?

A maioria das APIs do Yoplanning funciona dentro de uma única equipe, então o PipMCP precisa saber qual equipe usar. Você insere o ID da equipe uma vez junto com seu token API, e a IA trabalha nas sessões, reservas e clientes dessa equipe.