Saltar para o conteúdo
Logótipo Mindbody

Reservas

Integração Mindbody

Estúdios de pilates, yoga e treino com Mindbody: vendas faturadas no Moloni e clientes sincronizados com o Brevo.

Visão geral

Mindbody

O Mindbody é uma plataforma de gestão para estúdios de fitness, pilates, yoga e bem-estar. Gere horários de aulas, marcações de sessões individuais, clientes, contratos de adesão, packs de aulas e vendas no balcão, com a aplicação Mindbody para os clientes reservarem.

A faturação portuguesa fica fora do Mindbody, e é aí que a Tejobit entra. Os webhooks do Mindbody avisam quando há um cliente novo, uma venda, uma adesão atribuída ou uma reserva numa aula (por exemplo client.created, clientSale.created ou classRosterBooking.created), e a ligação transforma esses eventos em documentos no Moloni, contactos no Brevo e registos de pagamento. O Moloni emite e comunica cada documento à AT.

Casos de uso

Para que serve

  • Estúdio de pilates reformer em Lisboa que vende packs de 10 aulas e quer a fatura emitida no momento da compra.
  • Estúdio de yoga que acolhe novos alunos com uma sequência de emails no Brevo assim que se registam no Mindbody.
  • Ginásio boutique com adesões mensais que precisa de faturar cada renovação com o NIF do cliente.
  • Estúdio que quer recuperar alunos que deixaram de reservar aulas, com campanhas no Brevo baseadas na última reserva.
  • Centro de bem-estar com massagens e aulas que usa taxas de IVA diferentes por serviço.
IN

O que a ligação escuta

  • client.created e client.updated, para clientes novos ou dados alterados.
  • clientSale.created, para vendas de packs, produtos e serviços.
  • clientMembershipAssignment.created e clientMembershipAssignment.cancelled, para adesões.
  • classRosterBooking.created e classRosterBooking.cancelled, para reservas em aulas.
  • appointmentBooking.created, para sessões individuais.
OUT

O que a ligação faz

  • Cria o cliente e o documento no Moloni com o artigo e a taxa de IVA certos.
  • Adiciona ou atualiza o contacto no Brevo com atributos como plano, estúdio e última aula.
  • Regista pagamentos feitos no Stripe quando a venda não passa pelo balcão do Mindbody.
  • Remove de listas promocionais quem cancela a adesão, ou move para uma sequência de reativação.

Como funciona

Do pedido à ligação em funcionamento

  1. 01

    Pedido

    O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.

  2. 02

    Análise e proposta

    A Tejobit confirma o que a API permite e envia uma proposta com o fluxo, o preço e o prazo.

  3. 03

    Configuração e testes

    A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.

  4. 04

    Manutenção e monitorização

    A Tejobit aloja a ligação, acompanha os erros e adapta-a quando a API muda.

A ligação corre na infraestrutura da Tejobit. A mensalidade cobre o alojamento, a monitorização e as alterações da API.

O que é preciso preparar

  • Conta de programador no Mindbody com acesso em produção aprovado pelo Mindbody.
  • Ligação ativada entre a conta de programador e o site do estúdio no Mindbody.
  • Lista de serviços e produtos do Mindbody com o artigo e a taxa de IVA correspondentes no Moloni.
  • Acesso ao Moloni e ao Brevo, e consentimento de marketing recolhido nos registos.

Por segurança, não envie passwords, chaves API ou tokens pelo formulário. As credenciais são pedidas por um canal seguro quando a configuração começa.

Limites

  • O acesso em produção à API do Mindbody depende de aprovação do próprio Mindbody.
  • A API tem um limite diário de chamadas definido na chave; aumentos são pedidos ao gestor de conta do Mindbody.
  • O NIF não é um campo nativo de faturação portuguesa no Mindbody; é preciso um campo próprio ou pedir o dado no momento da venda.

Perguntas frequentes

Antes de começar

O Mindbody tem de aprovar a integração?

Sim. O acesso à API em produção é concedido pelo Mindbody e depois ligado ao site do estúdio. A Tejobit trata do pedido e da configuração.

Como é verificado que um evento veio mesmo do Mindbody?

Cada webhook traz uma assinatura no cabeçalho X-Mindbody-Signature, que a ligação valida antes de agir.

Posso usar isto com vários estúdios?

Sim. Cada site do Mindbody é ligado à conta de integração e pode ter a sua série de faturação e as suas listas no Brevo.

Ativar a integração Mindbody?

Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.