Webhooks

Primește alerte la evenimente și automatizează acțiuni în aplicațiile tale

La câteva clipe după ce se întâmplă ceva în Enlivy (o factură e plătită, intră o tranzacție, se schimbă un utilizator), un webhook anunță sistemul tău. Reacționezi la evenimente, în loc să verifici periodic dacă s-a schimbat ceva sau să aștepți rapoarte.

Creează un cont gratuit

Cont gratuit, fără card. Ca să trimiți evenimente, ai nevoie de cel puțin un pachet plătit, de la 15,55 lei/lună, fără TVA.

O destinație webhook cu evenimentele la care este abonată și livrările recente; adresa acoperită

CE ESTE

Se schimbă ceva. Sistemele tale reacționează.

Afli primul ce se schimbă: îți ții sistemele la zi cu evenimentele trimise de Enlivy.

Cu webhook-uri, aplicațiile tale reacționează la câteva clipe după ce se întâmplă ceva în Enlivy.

În loc să aștepți rapoarte sau să scrii cod costisitor care verifică mereu dacă s-a schimbat ceva, sistemul tău primește o notificare atunci când se schimbă datele.

Notificări la evenimente

Afli la câteva clipe după ce se creează sau se modifică o factură, o tranzacție, un utilizator sau alte date importante. Dacă endpoint-ul tău nu răspunde, trimiterea se reia.
Automatizare directă

Legi Enlivy direct de aplicațiile și fluxurile tale de lucru. Pornești acțiuni personalizate, sincronizezi alte aplicații sau ții rapoartele la zi, fără polling.

Adăugarea unei destinații de evenimente: un webhook care trimite un HTTP POST semnat către endpoint-ul tău sau un canal Slack

CE ESTE

Rămâi cu un pas înainte, cu date la zi

Webhook-urile Enlivy te ajută să-ți ții sistemele la zi și îți dau control complet asupra datelor și a fluxurilor de lucru.

Primești o notificare de fiecare dată când apar facturi, tranzacții, utilizatori sau alte evenimente importante, așa că nu mai depinzi de verificări manuale sau de rapoarte care vin cu întârziere.

Economisești timp

Cu notificările, ai mai puțină muncă manuală și reacționezi mai repede.
Mai puține erori

Datele tale rămân corecte și sincronizate în toate sistemele.
Integrări mai simple

Îți conectezi repede aplicațiile și fluxurile de lucru, cu foarte puține setări.

LIVRAREA EVENIMENTELOR

Te abonezi la evenimentele din Helpdesk

Alegi evenimente din Helpdesk, de exemplu o conversație nouă, atribuită sau fără răspuns, și le trimiți către o destinație webhook. Pentru fiecare abonament stabilești evenimentele și destinația.

DE CE WEBHOOK-URI

Rapide, de încredere și făcute pe măsura ta

Prin webhook-uri, Enlivy devine sursa de referință pe care o urmăresc toate aplicațiile tale.

Notificări semnate

La câteva clipe după ce se schimbă o factură, o tranzacție sau un utilizator, endpoint-ul tău primește datele evenimentului, semnate. Fără polling și fără să aștepți rapoarte.
Afli ce s-a schimbat fără să verifici de mână.
Complet personalizabile

Te abonezi doar la evenimentele care contează și alegi ce date legate de ele primești la fiecare. Primești exact ce îți trebuie pentru fluxul tău, nimic în plus.
Tu stabilești ce conține fiecare eveniment trimis.
Automatizare mai inteligentă

Pornești automat fluxuri, notificări și integrări, în loc să muți datele de mână.
Sistemele lucrează pentru tine, nu invers.
Un singur flux de date

Ții sincronizate toate instrumentele, platformele și aplicațiile dintr-un singur flux de evenimente.
Echipa ta se ocupă de decizii, nu de mutat date.
Fiabil și mereu activ

Livrările sunt constante și mereu active, iar fiecare trimitere e înregistrată, ca să vezi exact ce s-a întâmplat.
O livrare se încearcă de până la cinci ori, pe parcursul a aproximativ zece minute, iar proprietarul contului primește, o dată pe oră, un rezumat al livrărilor care tot au eșuat.
Crește odată cu tine

Fiecare pachet plătit activ include până la 25 de endpoint-uri.
Automatizarea rămâne simplă, oricât ai crește.

Referință API

Webhooks și livrarea evenimentelor prin API

Primești o notificare la scurt timp după ce se întâmplă ceva în contul tău. O destinație de evenimente este un endpoint, adică un webhook HTTPS sau un canal Slack, abonat la evenimentele care te interesează (o factură plătită, un contract actualizat, o tranzacție bancară creată). De fiecare dată când apare unul dintre ele, destinația primește un payload semnat.

Fiecare trimitere se înregistrează ca livrare, așa că vezi exact ce s-a trimis și ce a răspuns endpoint-ul tău. Referința acoperă tot ciclul: creezi și modifici destinații, le abonezi la evenimente, trimiți un test, le ștergi și citești jurnalele de livrare, cu datele lor.

Listezi destinațiile configurate. Poți obține și una singură, împreună cu evenimentele la care e abonată și livrările recente, prin parametrul include.

GET/organizations/<organization_id>/event-destinations+1

# listezi toate destinațiile
curl 'https://api.enlivy.com/organizations/<organization_id>/event-destinations' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

# o destinație, cu abonările și livrările ei incluse
curl -G 'https://api.enlivy.com/organizations/<organization_id>/event-destinations/<event_destination_id>' \
  --data-urlencode 'include=event_subscriptions,event_deliveries' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

const baseUrl = "https://api.enlivy.com";
const token = process.env.ENLIVY_API_TOKEN;
const organizationId = "<organization_id>";
const eventDestinationId = "<event_destination_id>";

const headers = {
  Authorization: `Bearer ${token}`,
  Accept: "application/json",
};

// listezi toate destinațiile
const result1 = await fetch(`${baseUrl}/organizations/${organizationId}/event-destinations`, {
  method: "GET",
  headers,
}).then((response) => response.json());

// o destinație, cu abonările și livrările ei incluse
const query = new URLSearchParams({
  include: "event_subscriptions,event_deliveries",
});
const result2 = await fetch(`${baseUrl}/organizations/${organizationId}/event-destinations/${eventDestinationId}?${query}`, {
  method: "GET",
  headers,
}).then((response) => response.json());

Înregistrezi un endpoint de webhook (sau Slack) și îl abonezi la evenimente. Pentru fiecare eveniment poți alege ce date legate să fie incluse și un șablon de mesaj opțional. Răspunsul conține un signing_secret, cu care verifici semnătura payload-urilor primite prin webhook.

POST/organizations/<organization_id>/event-destinations

curl -X POST 'https://api.enlivy.com/organizations/<organization_id>/event-destinations' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "type": "webhook",
  "name": "My integration",
  "destination_url": "https://example.com/enlivy/webhooks",
  "is_active": true,
  "events": [
    {
      "event": "invoice.paid",
      "includes": [
        "line_items",
        "taxes"
      ],
      "config": {
        "message": "Invoice {{ invoice.number }} was paid"
      }
    },
    {
      "event": "contract.updated"
    }
  ]
}'

# Răspunsul conține: id, type, destination_url, signing_secret, is_active, name, config.

const baseUrl = "https://api.enlivy.com";
const token = process.env.ENLIVY_API_TOKEN;
const organizationId = "<organization_id>";

const result = await fetch(`${baseUrl}/organizations/${organizationId}/event-destinations`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    // webhook | slack
    type: "webhook",
    name: "My integration",
    // obligatoriu când type = webhook
    destination_url: "https://example.com/enlivy/webhooks",
    is_active: true,
    // Pentru Slack, renunți la destination_url și trimiți:
    //   type: "slack",
    //   organization_api_credential_id: "slack_credential_id",
    //   config: { channel: "#billing" },
    // te abonezi la unul sau mai multe evenimente (model: subiect.acțiune)
    events: [
      {
        // de exemplu invoice.created | invoice.paid | contract.updated
        event: "invoice.paid",
        includes: ["line_items", "taxes"],
        config: { message: "Invoice {{ invoice.number }} was paid" },
      },
      { event: "contract.updated" },
    ],
  }),
}).then((response) => response.json());

// Răspunsul conține: id, type, destination_url, signing_secret, is_active, name, config.

Actualizezi o destinație: îi schimbi URL-ul, o pui pe pauză sau o repornești ori redefinești evenimentele la care e abonată. Trimiți lista completă a evenimentelor la care vrei să fie abonată destinația.

PUT/organizations/<organization_id>/event-destinations/<event_destination_id>

curl -X PUT 'https://api.enlivy.com/organizations/<organization_id>/event-destinations/<event_destination_id>' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "is_active": false,
  "destination_url": "https://example.com/enlivy/webhooks/v2",
  "events": [
    {
      "event": "invoice.created"
    },
    {
      "event": "invoice.paid"
    }
  ]
}'

const baseUrl = "https://api.enlivy.com";
const token = process.env.ENLIVY_API_TOKEN;
const organizationId = "<organization_id>";
const eventDestinationId = "<event_destination_id>";

const result = await fetch(`${baseUrl}/organizations/${organizationId}/event-destinations/${eventDestinationId}`, {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    // oprești livrarea fără să ștergi destinația
    is_active: false,
    destination_url: "https://example.com/enlivy/webhooks/v2",
    events: [{ event: "invoice.created" }, { event: "invoice.paid" }],
  }),
}).then((response) => response.json());

Trimiți un eveniment de test către o destinație, ca să verifici că legătura funcționează de la un capăt la altul. Testul creează o livrare reală, pe care o vezi în jurnale.

POST/organizations/<organization_id>/event-destinations/<event_destination_id>/test

curl -X POST 'https://api.enlivy.com/organizations/<organization_id>/event-destinations/<event_destination_id>/test' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "event": "invoice.paid"
}'

const baseUrl = "https://api.enlivy.com";
const token = process.env.ENLIVY_API_TOKEN;
const organizationId = "<organization_id>";
const eventDestinationId = "<event_destination_id>";

const result = await fetch(`${baseUrl}/organizations/${organizationId}/event-destinations/${eventDestinationId}/test`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    // opțional; lipsă = se trimite un eveniment de test generic
    event: "invoice.paid",
  }),
}).then((response) => response.json());

Citești jurnalul tuturor evenimentelor trimise. Filtrezi după destinație, după unul sau mai multe evenimente, după statusul livrării și după dată. Așa găsești cel mai repede eșecurile și reîncercările.

GET/organizations/<organization_id>/event-destinations/deliveries

# event și status acceptă liste: trimiți fiecare valoare cu sufixul []
# status: pending | success | failed | dropped | anomaly
curl -G 'https://api.enlivy.com/organizations/<organization_id>/event-destinations/deliveries' \
  --data-urlencode 'organization_event_destination_id=<destination_id>' \
  --data-urlencode 'event[]=invoice.paid' \
  --data-urlencode 'event[]=invoice.created' \
  --data-urlencode 'status[]=failed' \
  --data-urlencode 'created_at_from=2026-07-01' \
  --data-urlencode 'created_at_to=2026-07-31' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

const baseUrl = "https://api.enlivy.com";
const token = process.env.ENLIVY_API_TOKEN;
const organizationId = "<organization_id>";

// event și status acceptă liste: trimiți fiecare valoare cu sufixul []
// status: pending | success | failed | dropped | anomaly
const query = new URLSearchParams([
  ["organization_event_destination_id", "<destination_id>"],
  ["event[]", "invoice.paid"],
  ["event[]", "invoice.created"],
  ["status[]", "failed"],
  ["created_at_from", "2026-07-01"],
  ["created_at_to", "2026-07-31"],
]);
const result = await fetch(`${baseUrl}/organizations/${organizationId}/event-destinations/deliveries?${query}`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
  },
}).then((response) => response.json());

Obții o singură livrare cu toate datele ei: payload-ul exact trimis de Enlivy, statusul HTTP și body-ul pe care le-a returnat endpoint-ul tău și dacă a fost o reîncercare. Așa depanezi o livrare eșuată.

GET/organizations/<organization_id>/event-destinations/deliveries/<event_delivery_id>

curl 'https://api.enlivy.com/organizations/<organization_id>/event-destinations/deliveries/<event_delivery_id>' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

# Răspunsul conține: event, status, request_payload (ce am trimis),
# response_status + response_type + response (ce a răspuns endpoint-ul tău), is_retry.

const baseUrl = "https://api.enlivy.com";
const token = process.env.ENLIVY_API_TOKEN;
const organizationId = "<organization_id>";
const eventDeliveryId = "<event_delivery_id>";

const result = await fetch(`${baseUrl}/organizations/${organizationId}/event-destinations/deliveries/${eventDeliveryId}`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
  },
}).then((response) => response.json());

// Răspunsul conține: event, status, request_payload (ce am trimis),
// response_status + response_type + response (ce a răspuns endpoint-ul tău), is_retry.

Ștergi o destinație ca să oprești toate livrările către ea. Dacă vrei doar s-o pui temporar pe pauză, trimiți un PUT cu is_active false.

DELETE/organizations/<organization_id>/event-destinations/<event_destination_id>

curl -X DELETE 'https://api.enlivy.com/organizations/<organization_id>/event-destinations/<event_destination_id>' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

const baseUrl = "https://api.enlivy.com";
const token = process.env.ENLIVY_API_TOKEN;
const organizationId = "<organization_id>";
const eventDestinationId = "<event_destination_id>";

const result = await fetch(`${baseUrl}/organizations/${organizationId}/event-destinations/${eventDestinationId}`, {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
  },
}).then((response) => response.json());