Şirketler (B2B hesapları)
B2B ürünlerde kişiler bir şirkete (hesaba, çalışma alanına) bağlıdır: aynı şirketin yöneticisine fatura hatırlatması, tüm kullanıcılarına yeni özellik duyurusu gönderilir. Pushizo'da şirket ayrı bir nesnedir; kişiler…
B2B ürünlerde kişiler bir şirkete (hesaba, çalışma alanına) bağlıdır: aynı şirketin yöneticisine fatura hatırlatması, tüm kullanıcılarına yeni özellik duyurusu gönderilir. Pushizo'da şirket ayrı bir nesnedir; kişiler bir veya daha çok şirkete rolle bağlanır, şirket özellikleri segmentte ve şablonda kullanılır. Tüm planlarda açıktır (ADR-0090).
Veri modeli
| Alan | Açıklama |
|---|---|
external_id | Şirketin CRM veya hesap sisteminizdeki kimliği. App içinde tekildir; boşluk içeremez (en çok 128 karakter). |
name | Görünen ad (isteğe bağlı, en çok 200 karakter). |
domain | Alan adı (ör. ornek.com.tr); küçük harfe çevrilir, https:// ve sondaki / atılır. |
properties | Serbest JSON özellikleri (ör. plan, seats, mrr); en çok 5 seviye ve 16 KB. Güncellemede merge-patch uygulanır, null anahtarı siler. |
Üyelik role | Kişinin şirketteki rolü: küçük harf, rakam, _ ve - (ör. admin, member, billing); verilmezse member. |
Bir kişi birden çok şirkete bağlanabilir. Kişinin güncel şirketi en son bağlandığı (veya üyeliği en son güncellenen)
şirkettir; şablondaki company değişkeni bu şirkettir.
API
Panel: Kitle → Şirketler (şirket oluşturma, düzenleme, kişi ekleme/çıkarma) ve kişi profilinde Şirketler
kartı. Public API uçları users:read (okuma) ve users:write (yazma) kapsamlarıyla çalışır:
| Uç | Açıklama |
|---|---|
GET /v1/apps/{app_id}/companies | Liste (q, external_id, domain, limit, cursor), en yeni önce. |
POST /v1/apps/{app_id}/companies | external_id ile oluştur veya güncelle. |
POST /v1/apps/{app_id}/companies/batch | Toplu oluştur/güncelle (istek başına en çok 1000). |
GET, PATCH, DELETE /v1/apps/{app_id}/companies/{company_id} | Detay, güncelleme, silme (üyelikler silinir, kişiler kalır). |
GET /v1/apps/{app_id}/companies/{company_id}/members | Şirketin kişileri (role süzgeci). |
PUT, DELETE /v1/apps/{app_id}/companies/{company_id}/members/{user_id} | Kişiyi bağla / rolünü değiştir, çıkar. |
POST /v1/apps/{app_id}/companies/{company_id}/members/batch | Toplu kişi ekleme (user_id veya kişinin external_id değeri). |
GET /v1/apps/{app_id}/users/{user_id}/companies | Kişinin şirketleri; users/by/{label}/{value}/companies biçimi de vardır. |
curl -X POST https://api.pushizo.com/v1/apps/$APP_ID/companies/batch \
-H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
-d '{"companies":[{"external_id":"acme-001","name":"Acme A.Ş.","domain":"acme.com.tr","properties":{"plan":"enterprise","seats":120}}]}'
curl -X POST https://api.pushizo.com/v1/apps/$APP_ID/companies/$COMPANY_ID/members/batch \
-H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
-d '{"members":[{"external_id":"ayse","role":"admin"},{"external_id":"mehmet","role":"billing"}]}'Toplu kişi eklemede bulunamayan kişiler hata vermez; yanıttaki not_found listesinde istek sırasıyla döner.
Node SDK
const acme = await hs.companies.upsert({ external_id: 'acme-001', name: 'Acme A.Ş.', properties: { plan: 'enterprise' } });
await hs.companies.batchMembers(acme.id, { members: [{ external_id: 'ayse', role: 'admin' }] });
await hs.companies.setMember(acme.id, 'usr_01H...', { role: 'billing' });
const { data } = await hs.companies.forUserBy('external_id', 'ayse');Segment koşulları
Alan company.<ad> biçimindedir. Ayrılmış adlar id, external_id, name, domain ve role'dür; diğer adlar
şirket özelliğidir (company.plan → properties.plan).
| Koşul | Anlamı |
|---|---|
company.plan eq enterprise | Şirketlerinden en az biri enterprise planında olan kişiler. |
company.seats gte 50 | Sayısal özellik karşılaştırması (sayı olmayan değerler eşleşmez). |
company.role in [admin, billing] | Şirketlerinden birinde bu rollerden birine sahip kişiler. |
company.domain neq rakip.com | Hiçbir şirketi bu alan adında olmayan kişiler (şirketi olmayanlar dahil). |
company.id exists / not_exists | Herhangi bir şirkete bağlı olan / olmayan kişiler. |
Olumsuz operatörler (neq, not_in, not_exists) "hiçbir şirketi koşula uymayan" anlamına gelir. Her koşul ayrı
değerlendirilir: company.plan eq enterprise ve company.role eq admin birlikte kullanıldığında iki koşul farklı
şirketlerle sağlanabilir.
Şablonda kişiselleştirme
company kişinin güncel şirketidir; companies tüm şirketlerini (en çok 10, en son bağlanan önce) içerir. Şirketi
olmayan kişide company boştur; default filtresiyle yedek metin verin.
Merhaba {{ user.tags.first_name }}, {{ company.name | default: "ekibiniz" }} hesabınızda
{{ company.properties.seats }} koltuk var. Rolünüz: {{ company.role }}.
{% for c in companies %}{{ c.name }} ({{ c.role }}) {% endfor %}Değişkenler push, e-posta, SMS ve diğer kanalların render'ında aynıdır. Şablon önizlemesi örnek bir şirketle
(Acme, rol admin) gösterilir.
SQL görünümleri
SQL segmentte (Growth ve üzeri) companies ve company_members görünümleri okunabilir; ayrıntı
SQL sorgu ve SQL segment rehberindedir.
KVKK ve veri yaşam döngüsü
- Kişi silindiğinde (KVKK/GDPR silme) kişinin tüm şirket üyelikleri silinir; şirket kaydı kişiye ait olmadığından kalır.
- Kişi verisi dışa aktarımında (
/export)derived.companieslistesi kişinin şirketlerini ve rolünü içerir. - Kişiler birleştirildiğinde üyelikler hedef kişiye taşınır; hedef aynı şirkette zaten varsa hedefin rolü korunur.
- Şirket silindiğinde üyelikler silinir, kişiler kalır. "Verileri temizle" işlemi şirketleri ve üyelikleri de siler.
İstemci SDK'ları
Web ve mobil SDK'larda setCompany gibi bir yöntem yoktur. Şirket özellikleri birden çok kişi arasında paylaşılır ve
istemciden gelen yazma (kimlik doğrulaması olsa bile) kişinin o şirkete ait olduğunu kanıtlamaz; bir kullanıcı başka
bir şirkete kendini ekleyip o şirketin mesajlarını ve özelliklerini alabilirdi. Şirket ve üyelikleri sunucunuzdan
(public API, Node SDK, toplu içe aktarma veya Reverse ETL) yazın.