Base de conhecimento

Encontre respostas, tutoriais e guias práticos para aproveitar todos os recursos do sistema de reservas da mymento.

Como usar os Webhooks e quais informações são enviadas

Um Webhook permite que a mymento envie notificações automáticas para o seu sistema em tempo real, por meio de uma requisição HTTP POST. Com ele, você recebe avisos instantâneos sobre eventos — como novas vendas ou atualizações em vendas — sem precisar consultar constantemente a mymento.


Como funciona:

  1. Você informa uma URL HTTPS do seu sistema.
  2. Sempre que ocorrer um evento configurado (ex: nova venda ou alteração), a mymento enviará uma requisição POST com um objeto JSON contendo o tipo do evento (create ou update) e os dados completos da venda.
  3. (Opcional) Você pode definir um token de validação, que será enviado no cabeçalho "X-Webhook-Token", permitindo confirmar que a notificação veio da mymento.

Como configurar:

  1. Acesse Admin → Conexões → Webhook → Configurar ( https://admin.mymento.com.br/account/connections ).
  2. Informe a URL HTTPS do seu sistema.
  3. Selecione os tipos de evento que deseja receber.
  4. (Opcional) Informe um token de validação.

Importante: O uso de Webhooks requer que o módulo de API esteja contratado em sua conta mymento.

A seguir, um exemplo do objeto enviado pela mymento:
Venda
{
  "action": "update",
  "sale": {
    "code": "N40JKB",
    "firstname": "Pedro",
    "lastname": "Ferreira",
    "phone": "+55 21 99999-9999",
    "email": "pedro@mymento.com.br",
    "cpf_cnpj": "635.586.450-49",
    "scheduled_at": "2025-10-05T10:00:00.000-03:00",
    "created_at": "2025-09-30T15:13:46.270-03:00",
    "canceled_at": "2025-10-30T13:36:00.000-03:00",
    "finished_at": "2025-10-30T13:36:00.000-03:00",
    "payment_status": "Aberto",
    "value_full": 1500.0,
    "value": 1500.0,
    "value_paid": 0.0,
    "value_open": 1500.0,
    "value_down_open": 300.0,
    "value_down_confirmed": 0.0,
    "quantity": 5,
    "quantity_1": 3,
    "quantity_2": 2,
    "quantity_3": 0,
    "guide": "Marcos",
    "source": "Instagram",
    "uuid": "a12f45c7-893e-4c3e-a57a-9f92d3e2f817",
    "product": {
      "name": "Passeio de Quadriciclo"
    }
  }
}