API & Integrations

14. API & Integrations

API & Integrations բաժինը պարունակում է 7Stamp-ը ձեր արտաքին համակարգերի՝ CRM, POS, ERP, վերլուծության և մեսենջեր բոտերի հետ ծրագրային ինտեգրելու գործիքներ։

API բանալիներ

Բաժնի գլխավոր էջը API բանալիների ցանկն է։ Սյունակներ.

• Name — բանալու անվանումը (սովորաբար համընկնում է կապված Staff-ի անվան հետ)։
• Login — Staff-ի մուտքանունը, որին կապված է բանալին։
• API Key — բանալին ինքը (սկսվում է 7loc_sc_...-ով, լռելյայն թաքցված է, պատճենվում է մեկ սեղմումով)։
• Status — Active։
• 🔄 — վերագեներացնել բանալին։
• 🗑️ — ջնջել բանալին։

API բանալու ստեղծում

Սեղմեք + ADD API KEY — բացվում է Generate API Key պատուհանը.

• Scanner — բացվող ցանկ, որտեղ ընտրում եք աշխատակցի մուտքը, որին կկապվի բանալին (մեկ Staff-ը կարող է ունենալ մեկ բանալի)։
• CANCEL / GENERATE կոճակները։

GENERATE սեղմելուց հետո բանալին ստեղծվում է և հայտնվում ցանկում։ Պատճենեք այն անմիջապես. ամբողջական բանալին կարող է այլևս չցուցադրվել։

Ինչ կարող եք անել API-ի միջոցով

• Թողարկել քարտ հաճախորդի համար՝ ըստ էլփոստի կամ հեռախոսահամարի։
• Ավելացնել նշում կոնկրետ հաճախորդի համար։
• Թողարկել վաուչեր (ձևանմուշով կամ անհատական, Redeem Code-ով)։
• Մարել վաուչեր (եթե աշխատում եք ձեր սեփական 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։

Webhook payload-ի օրինակ

{
  "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)։

Հաղորդագրություններ մեսենջերներով 7loc.com-ի միջոցով

WhatsApp-ով, Telegram-ով և Viber-ով հաղորդագրություններ ուղարկելու համար միացվում է 7loc.com ինտեգրումը։ Ակտիվացումից հետո Campaigns բաժնում PUSH-ի և Email-ի կողքին հասանելի է դառնում «մեսենջերներ» ալիքը։

Սցենարներ առանց կոդի. Zapier և Make

7Stamp API + Webhooks-ն աշխատում են Zapier-ի և Make (Integromat)-ի հետ, ինչը թույլ է տալիս սցենարներ կառուցել առանց ծրագրավորման.

• «Երբ VOUCHER_REDEEMED — ավելացնել պիտակ Mailchimp-ում»։
• «Երբ REWARD_EARNED — ուղարկել ծանուցում Slack-ում»։
• «Երբ BIRTHDAY_GREETING — ստեղծել առաջադրանք CRM-ում»։

---