API & Integrations

14. API & Integrations

Секцията API & Integrations съдържа инструменти за програмна интеграция на 7stamp с вашите външни системи — CRM, POS, ERP, аналитика, messenger ботове.

API ключове

Главната страница на секцията е списъкът с API ключове. Колони:

• Name — име на ключа (обикновено съвпада с името на свързания Staff).
• Login — Staff входът, към който е свързан ключът.
• API Key — самият ключ (започва с 7loc_sc_..., скрит по подразбиране, копира се с едно щракване).
• Status — Active.
• 🔄 — регенериране на ключа.
• 🗑️ — изтриване на ключа.

Създаване на API ключ

Докоснете + ADD API KEY — отваря се изскачащият прозорец Generate API Key:

• Scanner — dropdown за избор на Staff Login, към който ще бъде свързан ключът (един Staff може да има един ключ).
• Бутони CANCEL / GENERATE.

След GENERATE ключът е създаден и се появява в списъка. Копирайте го веднага — пълният ключ може да не бъде показан отново.

Какво можете да правите чрез API

• Издаване на карта на клиент по имейл/телефон.
• Добавяне на stamp към конкретен клиент.
• Издаване на voucher (по шаблон или персонализиран, с Redeem Code).
• Реализиране на voucher (ако работите чрез собствен POS).
• Четене на състоянието на картата, прогреса, историята.
• Абониране за Webhooks, за да получавате събития в реално време.

Webhooks

Webhooks изпращат събития на картата към външна система. Поддържани (вижте речник на събитията):

• card_issued, card_saved, card_opened.
• stamp_added.
• goal_reached, reward_issued.
• voucher_issued, voucher_redeemed, voucher_expired.
• lottery_played (с резултата).
• birthday_reached.
• inactivity_trigger.
• campaign_sent.

Пример за payload на Webhook

{
  "event": "voucher_redeemed",
  "timestamp": "2026-05-11T12:34:56Z",
  "business_id": "b_123",
  "location_id": "loc_45",
  "customer": {
    "id": "c_789",
    "wallet_pass_id": "wp_abc",
    "language": "en"
  },
  "card": { "id": "card_001", "goal_index": 2 },
  "voucher": {
    "id": "v_555",
    "type": "voucher",
    "redeem_code": "FREECOFFEE",
    "redeem_code_formats": ["text", "qr", "barcode"],
    "status": "redeemed",
    "redeemed_via": "staff_scanner"
  }
}

Готови POS интеграции

• Poster — готова интеграция, свързва се с няколко щраквания.
• Serve — готова интеграция.
• Други каси — правят се по заявка. Безплатно, ако технически е възможно (т.е. вашата каса предоставя открит API или Webhooks).

Messenger излъчвания чрез 7loc.com

За излъчвания по WhatsApp, Telegram, Viber е свързана интеграцията 7loc.com. След активиране каналът “messengers” става достъпен в Campaigns до PUSH и Email.

No-code сценарии: Zapier и Make

7stamp API + Webhooks работят със Zapier и Make (Integromat), което ви позволява да изграждате сценарии без код:

• “Когато voucher_redeemed — добави таг в Mailchimp”.
• “Когато goal_reached — изпрати известие в Slack”.
• “Когато birthday_reached — създай задача в CRM”.

---