API & Integrations

14. API & Integrations

API & Integrations bölümü 7Stamp’ı CRM, POS, ERP, analitik ve mesajcı botları gibi harici sistemlerinizle programatik olarak bağlamak için araçları içerir.

API Keys

Bölümün ana sayfası API anahtarı listesidir. Sütunlar:

• Name — anahtar adı (genelde bağlı Staff adıyla eşleşir).
• Login — anahtarın bağlı olduğu Staff girişi.
• API Key — anahtarın kendisi (7loc_sc_... ile başlar, varsayılan gizli, tek tıkla kopyalanır).
• Status — Active.
• 🔄 — anahtarı yeniden üret.
• 🗑️ — anahtarı sil.

API anahtarı oluşturma

+ ADD API KEY’e dokunun — Generate API Key açılır penceresi:

• Scanner — anahtarın bağlanacağı Staff Login’i seçin (bir Staff’ın bir anahtarı olabilir).
• CANCEL / GENERATE düğmeleri.

GENERATE sonrası anahtar oluşturulur ve listede görünür. Hemen kopyalayın — tam anahtar bir daha gösterilmeyebilir.

API ile neler yapabilirsiniz?

• Müşteriye e-posta/telefon ile kart çıkarma.
• Belirli müşteriye damga ekleme.
• Şablonlu veya özel voucher düzenleme (Redeem Code ile).
• Kendi POS’unuz üzerinden çalışıyorsanız voucher kullanımı.
• Kart durumunu, ilerlemeyi, geçmişi okuma.
• Olayları gerçek zamanlı almak için Webhooks aboneliği.

Webhooks

Webhooks kart olaylarını harici sisteminize gönderir. Desteklenenler (olay sözlüğü için):

• 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 örneği

{
  "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
    }
  }
}

Hazır POS entegrasyonları

• Poster — hazır entegrasyon, birkaç tıkta bağlanır.
• Serve — hazır entegrasyon.
• Diğer kasalar — talep üzerine yapılır. Teknik olarak mümkünse ücretsizdir (yani kasanız açık API veya Webhooks sunuyorsa).

7loc.com üzerinden mesajcı yayınları

WhatsApp, Telegram, Viber yayınları için 7loc.com entegrasyonu bağlanır. Etkinleştikten sonra Campaigns içinde PUSH ve Email’in yanında “messengers” kanalı kullanılabilir.

No-code senaryolar: Zapier ve Make

7Stamp API + Webhooks Zapier ve Make (Integromat) ile kod yazmadan senaryo kurmanızı sağlar:

• “VOUCHER_REDEEMED olduğunda Mailchimp’te etiket ekle”.
• “REWARD_EARNED olduğunda Slack’e bildirim gönder”.
• “BIRTHDAY_GREETING olduğunda CRM’de görev oluştur”.

---