Facebook a Instagram do vlastního CRM: Jak propojit API
Reklama přináší kontakty, ale obchod je ručně přepisuje a neví, co se ztratilo. Propojení s CRM má udržet jednu dohledatelnou cestu od formuláře ke konkrétnímu člověku. Ukážeme postup od oprávnění přes první test až po výpadky a provoz.
01Nejdřív vyberte konkrétní tok dat
Zákazník vyplní reklamní formulář na Instagramu. Obchodník ale sleduje jen e-mail, kontakt přepíše do CRM až večer a další kolega ho druhý den osloví znovu. Pro první verzi propojení zvolte jediný výsledek: jedna poptávka má vzniknout jednou, získat odpovědného člověka a zůstat dohledatelná podle původního zdroje.
Rozlišujte formuláře reklam, soukromé zprávy, komentáře a zpětné odesílání obchodních událostí pro měření. Nejde o jeden univerzální konektor. Každý tok potřebuje vlastní oprávnění, datový model a provozní pravidla. Níže stavíme první verzi kolem reklamního leadu; zprávy připojíme jako samostatný kanál.
| Potřeba | Co navrhnete | Výsledek v CRM |
|---|---|---|
| Poptávka z reklamního formuláře | Příjem oznámení a načtení leadu | Poptávka, zdroj, odpovědná osoba |
| Zpráva na Instagramu | Napojení podporované schránky | Konverzace a její obsluha |
| Výsledek obchodního jednání | Samostatný tok zpět do měření | Odeslaná událost s dohledatelným stavem |
02Připravte účty, oprávnění a vlastníka integrace
Před programováním sepište firmu, stránku, reklamní účet, formuláře a instagramový účet, které skutečně propojujete. Určete správce aplikace a zastupujícího kolegu. Dodavatel nemá být jediným člověkem, který může obnovit přístup. Tajemství ukládejte na serveru ve správě tajných údajů, nikoliv do zdrojového kódu webu nebo sdílené tabulky.
Pro Instagram ověřte přihlašovací variantu. Dokumentace Meta pro Facebook Login počítá s profesionálním instagramovým účtem propojeným se stránkou. U Instagram Login se liší oprávnění. Nekombinujte názvy oprávnění z různých návodů. Podle vybraného produktu ověřte také požadované schválení aplikace a přístup k účtům mimo testovací role.
Do zadání přidejte tabulku potřebných operací a nejmenších oprávnění. Čtení poptávek samo o sobě neznamená oprávnění publikovat příspěvky. U každého tokenu evidujte vlastníka, účel, postup obnovy a způsob upozornění na selhání; samotnou hodnotu v provozním přehledu nezobrazujte.
03Přiveďte první testovací lead až do CRM
Oficiální kontrolní postup Meta propojuje odběr webhooků pro pole leadgen, přihlášení aplikace ke stránce, testovací lead a jeho načtení. Webhook berte jako oznámení události. Podle leadgen_id načtete potřebná data, která následně převádíte do struktury svého CRM.
- Vytvořte v testovacím prostředí cílová pole a jednoznačný externí identifikátor poptávky.
- Nastavte serverový HTTPS endpoint pro webhook a ověření příchozího požadavku podle dokumentace vybraného produktu.
- Přihlaste aplikaci k požadovaným událostem a konkrétní stránce.
- Vytvořte testovací lead, načtěte jeho údaje a uložte jedinou poptávku.
- Ověřte zdrojový identifikátor, čas, obsah polí, přidělení obchodníkovi a viditelný další krok.
Použijte testovací údaje. Do ukázek v zadání ani do veřejných logů nevkládejte skutečné kontakty. Úspěšná odpověď HTTP ještě nepotvrzuje, že poptávku vidí správný člověk. Převzetí propojení končí až kontrolou v CRM.
04Namapujte pole a nenechte integraci hádat
Pro každé pole určete zdroj, datový typ, povinnost a zacházení s prázdnou hodnotou. Telefon je text, nikoliv číslo určené k výpočtu. Zachovejte předvolbu. Nepovažujte chybějící firemní název za chybu, pokud ho původní formulář vůbec nepožadoval.
Ukládejte identifikátor formuláře a jeho verzi nebo vlastní mapovací revizi. Pokud marketing přidá otázku, zpracování nesmí potichu přesunout odpověď do špatného pole. Neznámé povinné mapování zastavte do fronty výjimek s vysvětlením pro správce.
Oddělte kontakt od poptávky. Stejný člověk může poslat dvě různé žádosti a obě mají obchodní význam. Duplicitní technické doručení stejného leadu naproti tomu novou poptávku vytvářet nemá. Připojení ke kontaktu podle e-mailu musí respektovat pravidla firmy a případné sdílené adresy.
05Připravte frontu, opakování a dohledání výpadku
Doporučujeme přijmout ověřenou událost do trvalé fronty a vlastní práci dělat odděleně. CRM může být krátce nedostupné; příjem reklamních kontaktů kvůli tomu nemá záviset na jednom dlouhém požadavku. Potvrzujte přijetí teprve ve chvíli, kterou váš návrh skutečně umí garantovat.
Zaveďte unikátní klíč zdrojové události, bezpečné opakování a záznam posledního dokončeného kroku. Ilustrační situace: CRM poptávku uloží, ale odpověď se ztratí. Při dalším pokusu nejdřív ověřte původní identifikátor. Bez této kontroly může mít obchod dvě stejné položky.
Rozlišujte dočasný výpadek, neplatné pole a ztrátu oprávnění. Dočasnou chybu lze opakovat s rostoucím odstupem; neplatné mapování potřebuje opravu. Sledujte stáří nejstarší čekající položky, nevyřízené chyby a rozdíly mezi zdrojem a CRM. Pro obnovu navrhněte kontrolované dočtení chybějících leadů s respektováním limitů API.
06Zprávy na Instagramu připojte jako konverzace
Zpráva není totéž co vyplněný leadový formulář. Dokumentace Meta ke zprávám uvádí oprávnění instagram_business_manage_messages pro příslušnou variantu a požadavek, aby uživatel nejprve napsal profesionálnímu účtu. Nedělejte z API nástroj k hromadnému oslovování lidí, kteří s firmou konverzaci nezačali.
V CRM zachovejte vlákno, kanál a odpovědného člověka. Obsluha má vidět, zda už kolega odpovídá a zda byla zpráva odeslána. Před spuštěním zvlášť ověřte platná pravidla pro odpovědi, podporované přílohy a omezení konkrétního přihlašovacího postupu. Do nabídky neslibujte funkci jen proto, že existuje v mobilní aplikaci Instagram.
07Osobní údaje a měření navrhněte odděleně
Přenos do CRM nenahrazuje rozhodnutí, proč smíte údaje zpracovávat a jak dlouho je potřebujete. S odpovědnou osobou určete účel, právní základ, přístupy, dobu uchování a způsob vyřízení žádostí zákazníka. Text původního formuláře musí odpovídat skutečnému použití údajů. Obchodní poptávka není automatický souhlas s libovolným newsletterem. Účel, minimalizaci a omezení uložení stanoví článek 5 GDPR; právní základy rozlišuje článek 6.
Pokud chcete posílat obchodní výsledky zpět do reklamního měření, zadejte samostatnou etapu. Určete přesný význam události, čas, unikátní identifikátor a povolené údaje. Úspěšné přijetí události platformou samo o sobě nedokazuje správné přiřazení reklamy ani přírůstkový přínos kampaně. Nejprve dokončete spolehlivý příjem poptávek.
08Před spuštěním převezměte i nepříjemné scénáře
- Stejná událost dorazí dvakrát a v CRM zůstane jediná poptávka.
- CRM uloží data, ale spojení skončí před potvrzením.
- Marketing změní formulář nebo přidá nepovinné pole.
- Token přestane fungovat a správce dostane srozumitelnou informaci.
- Po výpadku se čekající položky doplní bez ručního přepisování.
- Odstranění nebo omezení přístupu k zákaznickým údajům se promítne do připojených systémů podle navržených pravidel.
Spusťte nejprve jednu stránku a jeden formulář. Určete, kdo první dny kontroluje počty a komu patří opravy. Dodavatel má předat popis mapování, přístupů, obnovy a provozních výjimek. Pravidelně prověřujte podporovanou verzi API a změny dokumentace; číslo verze nekopírujte bez kontroly ze starého návodu.
09Časté otázky před propojením
Musíme mít CRM na míru?
Ne. Nejprve ověřte hotový konektor vašeho CRM a jeho chování při chybách, duplicitách a změně formuláře. Vlastní integrace dává smysl, pokud standardní propojení nepokrývá důležitá pravidla nebo potřebné údaje.
Stačí předat dodavateli heslo k Facebooku?
Ne. Použijte oficiální správu přístupů a oprávnění aplikace. Sdílené heslo nenahrazuje správně nastavenou integraci a zhoršuje dohledatelnost odpovědnosti.
Jak poznáme, že je propojení hotové?
Předvedete běžný i chybný průchod, porovnáte zdroj s CRM a určíte člověka, který řeší výjimky. Nestačí snímek jednoho úspěšného API požadavku.
Připravte seznam účtů, ukázku formuláře bez osobních údajů a očekávaný záznam v CRM. Při návrhu integrace a API s vámi projdeme tok dat, oprávnění i převzetí provozu. Souvislosti vysvětluje také náš průvodce propojením systémů přes API.