PushizoDocs

Ş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

AlanAçıklama
external_idŞirketin CRM veya hesap sisteminizdeki kimliği. App içinde tekildir; boşluk içeremez (en çok 128 karakter).
nameGörünen ad (isteğe bağlı, en çok 200 karakter).
domainAlan adı (ör. ornek.com.tr); küçük harfe çevrilir, https:// ve sondaki / atılır.
propertiesSerbest JSON özellikleri (ör. plan, seats, mrr); en çok 5 seviye ve 16 KB. Güncellemede merge-patch uygulanır, null anahtarı siler.
Üyelik roleKiş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}/companiesListe (q, external_id, domain, limit, cursor), en yeni önce.
POST /v1/apps/{app_id}/companiesexternal_id ile oluştur veya güncelle.
POST /v1/apps/{app_id}/companies/batchToplu 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/batchToplu kişi ekleme (user_id veya kişinin external_id değeri).
GET /v1/apps/{app_id}/users/{user_id}/companiesKiş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şulAnlamı
company.plan eq enterpriseŞirketlerinden en az biri enterprise planında olan kişiler.
company.seats gte 50Sayı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.comHiçbir şirketi bu alan adında olmayan kişiler (şirketi olmayanlar dahil).
company.id exists / not_existsHerhangi 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.companies listesi 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.

Bu sayfada