Mire használható a SOMACRM API?

A SOMACRM webservice segítségével külső rendszerek kapcsolhatók a CRM-hez. Tipikus felhasználási esetek:

• új vevőjelölt, kapcsolat vagy cég rögzítése weboldalról, webshopból vagy külső űrlapból;
• meglévő CRM rekord adatainak lekérése;
• meglévő rekord módosítása;
• ajánlat, rendelés, számla vagy hibajegy adatainak átadása;
• külső ERP, webáruház, ügyfélportál vagy egyedi alkalmazás összekötése a SOMACRM-mel.

Az API-t fejlesztőknek és integrátoroknak ajánljuk. Nyilvános frontend JavaScriptből közvetlenül ne hívják meg, mert a hozzáférési kulcs nem kerülhet ki a böngészőbe.

Alap adatok

A webservice végpont minden SOMACRM rendszerben az adott CRM domain alatt érhető el:

https://sajat-crm-domain.hu/webservice.php

A kapcsolódáshoz szükséges:

Adat	Leírás
CRM URL	A SOMACRM rendszer alap URL-je vagy közvetlenül a webservice.php végpont.
Felhasználónév	A CRM-ben létrehozott felhasználó neve.
Hozzáférési kulcs	A felhasználó profil oldalának alján található access key.
Modulnév	Annak a CRM modulnak az API neve, amelyben dolgozni szeretnénk. Például Leads, Accounts, Contacts.

A hozzáférési kulcs jelszóként kezelendő. Ne kerüljön GitHubra, weboldal forrásába, böngészőbe vagy e-mailben továbbított nyílt kódba.

Javasolt biztonsági beállítások

Éles kapcsolathoz javasolt külön integrációs felhasználót létrehozni. Ennek csak azokhoz a modulokhoz és mezőkhöz legyen joga, amelyekre az integrációnak ténylegesen szüksége van.

Javasolt szabályok:

• HTTPS használata kötelező.
• Az access key titkos konfigurációban legyen, ne a publikus kódban.
• Frontendből ne legyen közvetlen API-hívás, használjon saját backend proxyt.
• Éles PHP kódban ne legyen kikapcsolva az SSL tanúsítvány ellenőrzése.
• Nagy mennyiségű adatmozgásnál legyen naplózás és hibakezelés.
• Érdemes teszt CRM rendszerben kezdeni az integrációt.

Bejelentkezési folyamat

A SOMACRM webservice kétlépcsős azonosítást használ.

1. Challenge token lekérése

GET /webservice.php?operation=getchallenge&username=FELHASZNALONEV

A válaszban érkezik egy token érték.

2. AccessKey előállítása

A belépéshez nem a nyers hozzáférési kulcsot kell beküldeni, hanem az alábbi MD5 hash-t:

$generatedKey = md5($token . $accesskey);

3. Login kérés

POST /webservice.php
operation=login
username=FELHASZNALONEV
accessKey=GENERALT_MD5_KULCS

Sikeres válasz esetén a rendszer visszaadja a sessionName értéket. A további API műveletekhez ezt kell használni.

Rekordazonosító formátum

A CRM rekordok webservice azonosítója nem csak a sima CRM ID. A formátum:

modulPrefixxCRMID

Példa:

13x746840

A modul prefix a modul leírásából kérdezhető le describe művelettel. A mellékelt PHP osztály ezt automatikusan kezeli a getCrmModuleIds() metódussal.

Modul leírásának lekérése

A modul mezőinek, kötelező mezőinek és prefixének ellenőrzésére használható:

GET /webservice.php?sessionName=SESSION_ID&operation=describe&elementType=Contacts

Ez különösen fontos új rekord létrehozás előtt, mert a kötelező mezők modulonként eltérhetnek.

Adat lekérése CRM-ből

PHP példa:

<?php
include_once('CRMWebservice.php');

$url = 'https://sajat-crm-domain.hu/';
$username = 'api_felhasznalo';
$accesskey = 'felhasznalo_hozzaferesi_kulcsa';

$CRMWebservice = new CRMWebservice($username, $accesskey, $url);

$crmid = 12345;
$modulename = 'Contacts';

$record = $CRMWebservice->getCrm($crmid, $modulename);

echo '<pre>';
var_dump($record);
echo '</pre>';

Ahol:

• $crmid: a lekérendő adat CRM ID-ja;
• $modulename: a modul API neve, amelyből a lekérés történik.

Új adat rögzítése CRM-be

PHP példa kapcsolattartó létrehozására:

<?php
include_once('CRMWebservice.php');

$url = 'https://sajat-crm-domain.hu/';
$username = 'api_felhasznalo';
$accesskey = 'felhasznalo_hozzaferesi_kulcsa';

$CRMWebservice = new CRMWebservice($username, $accesskey, $url);

$modulename = 'Contacts';

$recordData = array(
    'lastname' => 'Teszt',
    'firstname' => 'Kapcsolat',
    'assigned_user_id' => '1'
);

$record = $CRMWebservice->createCrm($recordData, $modulename);

echo '<pre>';
var_dump($record);
echo '</pre>';

Ahol:

• $recordData: a rögzítendő adatok tömbje;
• $modulename: a modul API neve, amelybe a rekord létrejön.

Megjegyzés: az assigned_user_id értékének olyan felhasználóra kell mutatnia, amelyhez a rekord hozzárendelhető. Egyedi rendszereknél ezt előzetesen egyeztetni kell.

Meglévő adat módosítása CRM-ben

PHP példa:

<?php
include_once('CRMWebservice.php');

$url = 'https://sajat-crm-domain.hu/';
$username = 'api_felhasznalo';
$accesskey = 'felhasznalo_hozzaferesi_kulcsa';

$CRMWebservice = new CRMWebservice($username, $accesskey, $url);

$crmid = 12345;
$modulename = 'Contacts';

$recordData = array(
    'lastname' => 'Módosított vezetéknév',
    'firstname' => 'Módosított keresztnév'
);

$success = $CRMWebservice->editCrm($recordData, $crmid, $modulename);

var_dump($success);

Ahol:

• $recordData: a módosítandó mezők tömbje;
• $crmid: a módosítandó CRM rekord ID-ja;
• $modulename: a modul API neve, amelyben a rekord található.

A módosítás előtt a minta osztály lekéri az aktuális rekordot, ráírja a megadott mezőket, majd teljes rekordként küldi vissza az update művelethez.

Query alapú lekérdezés

A webservice támogat lekérdezéseket is. Példa:

$query = "select * from Contacts where lastname='Teszt';";
$result = $CRMWebservice->getCrmQuery($query, array(
    'url' => 'https://sajat-crm-domain.hu/webservice.php'
));

Javaslat: query használatakor minden külső bemenetet validálni és tisztítani kell. Ne építsünk ellenőrizetlen felhasználói adatból közvetlen query-t.

Gyakori modulnevek

Modulnév	SOMACRM jelentés
Calendar	Naptár, teendők, események
Leads	Vevőjelöltek
Accounts	Cégek
Contacts	Kapcsolatok
Potentials	Lehetőségek
Products	Termékek
Documents	Dokumentumok
Emails	E-mailek
HelpDesk	Ügyfélszolgálati kérések / hibajegyek
Faq	Tudásbázis / GYIK
Vendors	Beszállítók
PriceBooks	Árlisták
Quotes	Ajánlatok
PurchaseOrder	Beszerzési rendelések
SalesOrder	Megrendelések
Invoice	Számlák / díjbekérők, rendszerbeállítástól függően
Campaigns	Kampányok
Events	Események
Users	Felhasználók
Groups	Felhasználói csoportok
Currency	Pénznemek

Egyedi SOMACRM moduloknál az API modulnevet külön egyeztetni kell, mert az eltérhet a képernyőn látható magyar megnevezéstől.

Tipikus hibák és ellenőrzési pontok

Hiba	Lehetséges ok	Teendő
Sikertelen login	Rossz felhasználónév vagy access key	Ellenőrizze a CRM felhasználói profilban az access key-t.
ACCESS_DENIED vagy jogosultsági hiba	Az API felhasználónak nincs joga a modulhoz vagy mezőhöz	Jogosultság ellenőrzése a CRM-ben.
Rekord létrehozás sikertelen	Hiányzik kötelező mező	describe művelettel ellenőrizze a kötelező mezőket.
Update sikertelen	Nem teljes vagy rossz rekordazonosító	Ellenőrizze a modulPrefixxCRMID formátumot.
SSL/cURL hiba	Tanúsítvány, URL vagy szerverbeállítás gond	Éles rendszerben az SSL ellenőrzést javítani kell, nem kikapcsolni.
Hibás karakterek	Nem UTF-8 adatküldés	Küldés előtt minden szöveget UTF-8 formátumban kezeljen.

Minimális integrációs folyamat

1. Integrációs felhasználó létrehozása a SOMACRM-ben.
2. Jogosultságok beállítása csak a szükséges modulokra.
3. Access key lekérése a felhasználói profilból.
4. Teszt login a getchallenge és login művelettel.
5. Modulmezők ellenőrzése describe művelettel.
6. Teszt rekord létrehozása teszt rendszerben.
7. Teszt rekord lekérése és módosítása.
8. Hibakezelés, naplózás, jogosultságok ellenőrzése.
9. Élesítés előtt biztonsági felülvizsgálat.

Letölthető PHP mintaosztály

A SOMACRM webservice használatához adható egy PHP mintaosztály is. A minta célja a kapcsolódás, lekérdezés, létrehozás és módosítás bemutatása. Élesítés előtt a fejlesztőnek a saját rendszeréhez kell igazítania, különösen a hibakezelést, naplózást, jogosultságokat és SSL beállításokat.

Letöltés

Kapcsolat

Integrációs kérdés vagy egyedi API kapcsolat esetén keressen minket:

SOMACRM
Web: https://www.somacrm.hu
E-mail: [email protected]

A SOMACRM lehetőséget biztosít a Google Naptárral történő kétirányú szinkronizációra, így az események automatikusan megjelennek mindkét rendszerben.

Fontos előfeltétel

A szinkronizáció indításához először a SOMACRM üzemeltetőinek hozzá kell adniuk az adott e-mail címet a Google projekthez.
Enélkül a Google-fiók összekapcsolása nem lehetséges.

👉 Amennyiben még nem történt meg, kérjük jelezd felénk, melyik Google-fiókkal szeretnéd használni a szinkronizációt.

---

Google Naptár összekapcsolásának lépései

1. Nyisd meg a SOMACRM Naptár modult
2. Keresd meg a „Google Naptár szinkronizáció” vagy „Naptár beállítások” menüpontot
3. Kattints a „Google fiók összekapcsolása” gombra
4. Jelentkezz be a Google-fiókoddal, és engedélyezd a hozzáférést
5. Válaszd ki, melyik Google Naptárat szeretnéd szinkronizálni
6. Erősítsd meg a beállítást

---

Hogyan működik a szinkronizáció?

• 🔄 Kétirányú szinkronizáció
  • A SOMACRM-ben létrehozott események megjelennek a Google Naptárban
  • A Google Naptárban felvitt események megjelennek a SOMACRM-ben
• 📅 Csak az „Esemény” típusú bejegyzések szinkronizálódnak
  • Feladatok (taskok) nem kerülnek át egyik rendszerből a másikba

---

Hasznos tudnivalók

• A szinkronizáció automatikus, nincs szükség manuális frissítésre
• Egy felhasználó egyszerre egy Google-naptárt tud aktívan szinkronizálni
• Jogosultsági vagy belépési probléma esetén elsőként ellenőrizd, hogy az e-mail cím hozzá lett-e adva a Google projekthez

2025. november 23-án a budapesti Magnet Házban immár másodszor rendezik meg az Egészség Marketing Napot, Magyarország egyetlen olyan eseményét, amely kifejezetten az egészségügyi szakembereknek, szolgáltatóknak és forgalmazóknak nyújt szakmai támogatást a marketing, értékesítés és kapcsolatépítés területén.

Az egész napos konferencia célja, hogy a résztvevők azonnal használható tudást kapjanak, valamint hogy lehetőséget biztosítson számukra a szakmai kapcsolatok bővítésére.

---

Kapcsolatok nélkül nincs siker az egészségpiacon

Az egészségügyi szolgáltatások, termékek és praxisok fejlődésének egyik legfontosabb tényezője a bizalom. A bizalmat azonban elérni és fenntartani csak tudatos marketinggel és erős szakmai kapcsolati hálóval lehet.

„Az Egészség Marketing Nap célja, hogy az egészségügyi szakemberek végre olyan tudást kapjanak, amit másnap már be tudnak építeni a munkájukba. Ez a rendezvény nem elméletekről szól, hanem gyakorlati lépésekről, stratégiákról és valódi üzleti kapcsolatokról.”
– mondta Pletserné dr. Jung Andrea, a Naturportal Akadémia alapítója, az esemény főszervezője.

---

Kiemelt előadók 2025-ben

• Kriston Gábor – „AI az egészségügyben: áldás vagy átok?”
  Az AI szakértője, aki tíz éve Borsodszentgyörgyről indult, ma pedig saját fejlesztésű AI-rendszerével nemzetközi versenyeken utasít maga mögé olyan neveket, mint Russell Brunson és Alex Hormozi. Előadásában arra ad választ, hogyan lehet az AI-t hasznosan és etikus módon beépíteni az egészségügybe.
• Vida Ágnes – „Mit kell tudnod a marketingről 2026-ban?”
  Fedezd fel, hogyan szerezhetsz ügyfeleket és építhetsz márkát 2026 legújabb marketing trendjeivel – akkor is, ha eddig alig foglalkoztál ezzel! Gyakorlati példákon keresztül mutatom meg, mire lehet számítani, mi működik majd és hogyan tudod bevezetni a saját vállalkozásodban akkor is, ha most indulsz a nulláról. Lépj be magabiztosan a marketing világába és alakítsd te a piaci lehetőségeidet, ne fordítva!
• Langmár Zsuzsanna – „Hitelesség építése az egészségügyi szolgáltatóknál”
  Több mint 15 éves tapasztalattal segíti a vállalkozásokat abban, hogy üzeneteiket a megfelelő formában és csatornákon keresztül juttassák el a páciensekhez és ügyfelekhez.
• Sipos Lóránt – „Etika Intelligencia – Egy új civilizációs DNS”
  Az Etika Intelligencia bemutatja, hogyan tehető mérhetővé az emberi szándék, felelősség és méltóság – mintha egy új „etikai DNS-t” látnánk. Az előadás megmutatja, miként válhat az AI etikus szövetségese az egészségügyben és a társadalomban, új perspektívát adva az orvostudománynak és a jövő civilizációjának.
• Elek Ádám: “Mit csinálnak az ügyfeleid a weboldaladon?” 

Hogyan viselkednek az ügyfeleid a weboldaladon? Milyen apró jelek árulják el valódi szándékaikat? Hogyan lehet a látogatói viselkedést követni és értelmezni, hogy az online jelenlét valóban konverziókat és üzleti sikert hozzon? Az előadás gyakorlati eszközöket kínál minden vállalkozás számára, amely szeretné maximalizálni weboldala hatékonyságát és ügyfélélményét.

---

Program és különlegességek

• Kapcsolatépítő körök: Három nagyszabású networking program, ahol a résztvevők új partnereket és ügyfeleket találhatnak (VIP jeggyel).
• Tombola és nyeremények: A kiállítói standok látogatásával pecséteket gyűjtve automatikusan részt lehet venni a sorsoláson.
• Társadalmi felelősségvállalás: Minden jegyvásárlásból 500 Ft a „A Rák Ellen – Az Emberért, A Holnapért Társadalmi Alapítvány” munkáját támogatja.

---

Praktikus információk

📅 Időpont: 2025. november 23.
📍 Helyszín: Magnet Ház, Budapest
🎟 Jegyek és részletek: https://jegyvetel.hu/egeszseg-marketing-nap/
📧 Kapcsolat: [email protected]

Ez az eszköz lehetővé teszi, hogy megjelenítse, ki hozta létre a rekordot a CRM rendszerében, azzal, hogy hozzáadja a „Létrehozó” mezőt a rekord részletes nézetéhez.

Létrehozó funkciók

• Megmutatja, ki hozta létre a rekordokat
• Új „Létrehozó” mező
• Új „Utoljára módosította” mező
• A mező feltételekhez és munkafolyamatokhoz használható
• Integrációs beállítások a mezők modulokban történő engedélyezésére/letiltására
• Kompatibilis minden modullal
• Ingyenes letöltés
• Könnyű telepítés és használat

Találkoztál már ezekkel a helyzetekkel?

• El kell távolítanod az összes Kapcsolatot a Kampányodból.
• El kell távolítanod az összes Vevőjelöltet a Kampányodból.
• El kell távolítanod az összes Céget a Kampányodból.

Eddig két lehetőséged volt:

1. Minden kapcsolatot/vevőjelöltet/céget egyesével távolítottál el.
2. A másik lehetőség az volt, hogy törölted a kampányodat, és újat hoztál létre.

Ma találsz egy jobb megoldást.
Lehetőséged van arra, hogy minden rekordot eltávolíts a Kapcsolatlistából, Vevőjelöltlistából vagy Céglistából néhány egyszerű lépésben.
Találd meg a Clear Campaigns4You megoldást.

Hogyan használd a Clear Campaigns SomaCrm kiegészítőt:

1. Nyisd meg a Kampányodat.
2. A Kampány Részletes nézetében kattints a Továbbiak gombra.

3. Törlés megerősítése