Ugrás a fő tartalomhoz
Hasznos volt ez az oldal?

Automatizálási receptek

Öt másolható kiindulási pont a Webhook meghívása akcióhoz — mindegyikhez cél, előfeltétel, lépések és egy azonnal átvehető konfiguráció. A Webhook meghívása akció általános működéséről lásd az Okosotthon-automatizálás oldalt, a bejövő oldalról (amikor egy külső rendszer indít el egy PrimeCal-szabályt) pedig a Webhookok oldalt.

Minden Webhook meghívása kérés JSON törzzsel megy

A PrimeCal kimenő webhook akciója mindig Content-Type: application/json fejléccel és JSON-kódolt törzzsel küld — nincs mód form-kódolásra váltani. Az alábbi receptek mindegyike vagy egy natívan JSON-t beszélő API-t hív közvetlenül, vagy egy köztes szolgáltatáson keresztül megy, ha a cél nem beszél JSON-t.

1. Home Assistant: eszköz bekapcsolása​

Cél: a PrimeCal hívja meg egy Home Assistant REST parancsot vagy webhookot, amikor egy esemény vagy feladat elindul.

Előfeltétel: a Home Assistant-példányodnak HTTPS-en, az internetről elérhetőnek kell lennie (egy csak helyi címet, mint a homeassistant.local, a rendszer elutasítja — lásd az Okosotthon-automatizálás oldalt, hogy miért, és hogyan tedd elérhetővé Home Assistant Cloud-dal vagy saját reverse proxyval). Szükséged lesz egy hosszú élettartamú hozzáférési tokenre a Home Assistanttől.

Lépések:

  1. Hozz létre vagy nyiss meg egy automatizálási szabályt a felhasználási módodhoz illő triggerrel (event.starts_in, task.scheduled_start, vagy webhook.incoming, ha magától a Home Assistanttől jön a trigger).
  2. Adj hozzá egy Webhook meghívása akciót.
  3. Töltsd ki az alábbi konfigurációt a saját példányod URL-jével, tokenjével és entitás-azonosítójával.
  4. Mentés — a webhook akció érzékeny akció, így a szabálynak jóváhagyásra van szüksége, mielőtt valóban lefutna (lásd az Automatizálási szabályok oldalt a jóváhagyási lépésről).
{
  "url": "https://<your-instance>.ui.nabu.casa/api/webhook/<webhook-id>",
  "method": "POST",
  "authType": "bearer",
  "authToken": "YOUR_HOME_ASSISTANT_LONG_LIVED_TOKEN",
  "customPayload": { "entity_id": "switch.washing_machine" }
}

Korlátok: egy akció egy kérést küld — láncolj több Webhook meghívása akciót ugyanabban a szabályban, ha több entitást szeretnél vezérelni.

A fordított irány: ha inkább a Home Assistant hívná meg a PrimeCal-t (hogy a PrimeCal webhook.incoming triggere elsüljön, vagy csak szeretnéd, hogy a Home Assistant reagáljon arra, amit a PrimeCal küld neki), töltsd le a PrimeCal Webhook Action blueprintet, és importáld a Home Assistantbe — lásd az Okosotthon-automatizálás oldalt az importálás lépéseiért. Ez egy webhook-végpontot ad a Home Assistant oldalán, és bármilyen műveletet kiválaszthatsz, amelyet lefuttat, a PrimeCal által küldött adattal sablonváltozóként elérhetővé téve.

2. Slack: üzenet közzététele​

Cél: a PrimeCal tegyen közzé egy Slack-üzenetet, amikor egy esemény létrejön, egy feladat állapota megváltozik, vagy bármilyen más trigger lefut.

Előfeltétel: egy bejövő webhook URL a Slack-csatornához, ahova posztolni szeretnél (Slack-munkaterület beállításai → Alkalmazások → Bejövő webhookok → Hozzáadás a Slackhez). Ez egy egyetlen URL, amelybe a csatorna már bele van sütve — nincs bot token, nincs OAuth.

Lépések:

  1. Hozz létre vagy nyiss meg egy szabályt a kívánt triggerrel (pl. event.created).
  2. Adj hozzá egy Webhook meghívása akciót.
  3. Illeszd be a bejövő webhook URL-edet url-ként, hagyd authType-ot none-on (az URL maga a titok), és állíts be egy customPayload-ot egy text mezővel. A smart value-k működnek a szövegben.
{
  "url": "https://hooks.slack.com/services/T000/B000/XXXXXXXXXXXXXXXXXXXXXXXX",
  "method": "POST",
  "authType": "none",
  "customPayload": { "text": "Új esemény: {{event.title}}, ekkor: {{event.startTime}}" }
}

Korlátok: egy bejövő webhook URL csak abba a csatornába posztol, amelyikhez létrehozták — hozz létre külön webhookot (és külön akciót vagy szabályt) minden csatornához, amelyet el szeretnél érni.

3. SMS-emlékeztető Vonage-on át​

Cél: szöveges üzenetes emlékeztető küldése egy beállítható idővel egy esemény kezdete előtt.

Előfeltétel: egy Vonage fiók bekapcsolt Messages API-val, egy alkalmazás-azonosító és privát kulcs, amelyet rövid élettartamú JWT-re cserélsz (a Vonage Messages API referenciája leírja, hogyan generálj egyet), és egy jóváhagyott küldőazonosító vagy szám az országodhoz.

Miért a Vonage Messages API-ja, nem a Twilio vagy a Vonage régebbi SMS API-ja

A Twilio REST API-ja és a Vonage klasszikus SMS API-ja (rest.nexmo.com/sms/json) is application/x-www-form-urlencoded törzset vár, amit a Webhook meghívása akció nem tud küldeni. A Vonage újabb Messages API-ja (api.nexmo.com/v1/messages) JSON törzset fogad el Bearer hitelesítéssel, így ez az, amelyik közvetlenül, köztes szolgáltatás nélkül működik ebből az akcióból.

{
  "url": "https://api.nexmo.com/v1/messages",
  "method": "POST",
  "authType": "bearer",
  "authToken": "YOUR_SHORT_LIVED_JWT",
  "customPayload": {
    "message_type": "text",
    "text": "Emlékeztető: {{event.title}} kezdete: {{event.startTime}}",
    "to": "YOUR_RECIPIENT_NUMBER",
    "from": "YOUR_SENDER_ID",
    "channel": "sms"
  }
}

Korlátok: egy Vonage Messages API JWT rövid élettartamú (jellemzően egy óránál kevesebb) — egy olyan szabályhoz, amelynek folyamatosan működnie kell, saját oldalon kell egy folyamat, amely frissíti a JWT-t és beírja a szabály authToken mezőjébe, mert ezt a PrimeCal nem kezeli helyetted.

4. Számlázás köztes szolgáltatáson át​

A PrimeCal-nak nincs natív számlázó-összekötője

A PrimeCal nem állít ki számlát, és nincs közvetlen kapcsolata semmilyen számlázó szolgáltatóval — sem a Számlázz.hu-val, sem a Billingóval. Ez a recept a PrimeCal webhookját egy általános célú automatizálási szolgáltatáson (Make, Zapier vagy n8n) vezeti át, amely aztán maga hívja meg a számlázó szolgáltató saját API-ját. Ezt a köztes lépést a szolgáltató saját platformján állítsd be és tartsd karban — a PrimeCal része a webhook elküldésénél véget ér.

Cél: egy számlázási folyamat elindítása egy magyar számlázó szolgáltatásban egy foglalás vagy esemény után.

Előfeltétel: egy Make, Zapier vagy n8n fiók, amelyben már létezik egy forgatókönyv/zap/workflow, amely elfogad egy bejövő webhookot, és elvégzi, amire a számlázó szolgáltatódnak szüksége van. Ez a köztes szolgáltatás ad neked egy saját webhook URL-t, amivel elindíthatod.

Lépések:

  1. Hozz létre vagy nyiss meg egy szabályt a kívánt triggerrel (pl. event.created egy olyan naptáron, amit számlázható munkára használsz, vagy notification.dispatched, notification.type szűrővel reservation.created-re, ha egy új foglalásra szeretnél reagálni).
  2. Adj hozzá egy Webhook meghívása akciót a köztes szolgáltatás webhook URL-jével.
  3. Építsd fel a payloadot azokkal a mezőkkel, amiket a köztes forgatókönyved vár — a smart value-k kitöltik a foglalás vagy esemény adatait.
{
  "url": "https://hook.<make-vagy-zapier-vagy-n8n>.example/your-scenario-id",
  "method": "POST",
  "authType": "none",
  "customPayload": {
    "event_title": "{{event.title}}",
    "event_date": "{{event.date}}",
    "trigger": "{{trigger.type}}"
  }
}

Korlátok: hogy a reservation.created szigorúan fizetés után fut-e, vagy fizetés előtt is lefuthat, azt a PrimeCal ma nem garantálja — adj hozzá egy feltételt bármelyik fizetésállapot-mezőre, amit a foglalási adataid valójában hordoznak, és teszteld a teljes láncot egy valódi foglalással, mielőtt rá hagyatkozol.

Számlázz.hu és Billingo: a köztes lépés konkrétan​

A fenti recept Make/Zapier/n8n oldali fele konkrétan a két legnépszerűbb magyar számlázó szolgáltatáshoz:

  • Számlázz.hu: a Számlázz.hu Agent (natív Make/Zapier/n8n-összekötő, nem a PrimeCal része) fogadja a köztes szolgáltatás webhookját, és a benne lévő adatokból (pl. event_title, a foglalás összege, a vendég neve) állít ki számlát a Számlázz.hu Agent saját API-ján keresztül.
  • Billingo: ugyanez a mintázat a Billingo API-jával — a köztes szolgáltatás hívja meg a Billingo végpontját, a PrimeCal csak az indító webhookot adja.

Mindkét esetben: a PrimeCal felhasználóneve, jelszava vagy API-kulcsa sosem kerül a Számlázz.hu vagy a Billingo felé, és fordítva sem — a két rendszer közötti egyetlen kapocs a köztes szolgáltatás saját, ott beállított hitelesítése.

5. Fali tablet vagy kioszk: eszköz párosítása és Képernyő kiválasztása​

Cél: egy tablet, Raspberry Pi vagy okostévé böngészőjének folyamatosan bekapcsolt kioszk módba állítása, amely a PrimeCal egyik rendszersablonjából épített Képernyőt mutatja.

Lépések:

  1. Párosítsd az eszközt — lásd az Eszköz párosítása oldalt a teljes 8 karakteres kódos folyamatért.
  2. Nyisd meg a Képernyők menüpontot a fő navigációból, menj a Sablonok fülre, és kattints az Alkalmazás Képernyőre gombra a ma elérhető három rendszersablon egyikén — Családi faliképernyő, Csapat standup tábla vagy Mai fókusz —, vagy építs saját elrendezést widgetekből.
  3. Rendeld hozzá azt a Képernyőt a párosított eszközhöz.

Az eszköz ezután folyamatosan lekérdezi a PrimeCal-tól a hozzárendelt Képernyő tartalmát, és csak megjelenítésre rendereli, saját felhasználói munkamenet nélkül — lásd az Eszköz párosítása és a Sablonok és megosztás oldalakat arról, hogyan működnek a sablonok, a tulajdonjog és a megosztás.

Lásd még​