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

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

Webhooks

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

• SCAN, DELIVERY_INSERT.
• REWARD_EARNED, LOTTERY_WIN.
• VOUCHER_ISSUED, ADMIN_VOUCHER_ISSUE, VOUCHER_REDEEMED.
• CARD_JOINED, CARD_ADDED_TO_WALLET, CARD_REMOVED_FROM_WALLET.
• CARD_CAMPAIGN, BIRTHDAY_GREETING.

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

{
  "entity": "card_event",
  "action": "created",
  "entity_id": 707,
  "event_id": "8f05e58decec48e09d328f0edebbacf6",
  "profile_id": 2,
  "profile_name": "Your Business",
  "profile_lang": "en",
  "data": {
    "event_type": "SCAN",
    "scanned_at": "2026-10-01T09:19:24.179424",
    "user_card_id": 10,
    "card_template_id": 14,
    "card_template_name": "Collect your stamps!",
    "stamps_added": 3,
    "stamps_before": 1,
    "stamps_after": 4,
    "amount": null,
    "external_order_id": "ORDER-1001",
    "workplace": { "id": 4, "name": "Bar Counter" },
    "device_type": null,
    "external_id": "odoo_contact_8821",
    "external_source": "odoo",
    "issued_vouchers": [
      {
        "id": 174,
        "unique_code": "100425813507",
        "stamp_number": 4,
        "issued_at": "2026-10-01T09:19:24.191836",
        "expires_at": "2027-01-01T23:59:59",
        "status": "ACTIVE",
        "voucher_template_id": 58,
        "voucher_description": "Free coffee",
        "voucher_image_url": "https://..."
      }
    ],
    "achieved_goals": [],
    "user": {
      "id": 2,
      "name": "Anna",
      "full_name": "Anna Smith",
      "email": "anna@example.com",
      "telegram_chat_id": null,
      "telegram_username": null,
      "whatsapp_phone": null,
      "birth_date": null
    }
  }
}

Готови 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”.
• “Когато REWARD_EARNED — изпрати известие в Slack”.
• “Когато BIRTHDAY_GREETING — създай задача в CRM”.

---