# Segmentic

> Segmentic is a customer engagement and marketing automation platform
> built for the Iranian market. It collects product events, builds
> audiences from them, and sends messages over SMS, push, web push, email,
> in-app, and the Iranian messengers Bale, Eitaa and Rubika. It is deployed
> inside Iran or on the customer's own infrastructure.

There are two customer facing HTTP surfaces and one MCP server.
The ingest surface takes events and is authenticated by a public write key.
The management surface reads and writes audiences, campaigns and reports and
is authenticated by a secret key that carries permissions. Full text of every
page below is at https://segmentic.net/llms-full.txt

## Start here

- [Segmentic technical documentation](https://segmentic.net/en/docs): A task-based map of Segmentic documentation: setup, data collection, engagement, analytics and developer reference.
- [Quickstart: from key to first event](https://segmentic.net/en/docs/quickstart): Create a key, send your first event and watch it arrive, in ten minutes and with one HTTP request.
- [Concepts: events, profiles, segments, campaigns, journeys](https://segmentic.net/en/docs/concepts): The ten ideas the rest of the documentation stands on, one paragraph each, named the way the panel and the API name them.

## Collect data

- [Designing events: what to send and what to call it](https://segmentic.net/en/docs/events): Naming rules, choosing properties and building a stable tracking plan for reports and segments.
- [An event dictionary for each kind of business](https://segmentic.net/en/docs/event-dictionary): Ready-made event and property lists for online retail, super-apps, fintech, travel, education and subscription media. Copy and start.
- [Putting events on your own site and app](https://segmentic.net/en/docs/instrument): From the business question to the line of code on the page: which events you need, where in the code to call them, and how to be sure they arrived.
- [Identity: anonymous and signed-in users](https://segmentic.net/en/docs/identity): How the history of somebody who has not signed in yet joins their account, and what happens when two people share one device.
- [The web SDK](https://segmentic.net/en/docs/sdk-web): Installing on a site, every method, the options, the offline queue and browser push.
- [The Android SDK](https://segmentic.net/en/docs/sdk-android): The official Android SDK for events, identity, push and in-app messages.
- [Registering a device for mobile push](https://segmentic.net/en/docs/devices): Register device tokens for mobile push, browser push and messengers.
- [Sending events server to server](https://segmentic.net/en/docs/server): For what only your backend is certain of: a captured payment, a shipped order, a cancelled subscription.
- [The product catalogue: filling it and keeping it true](https://segmentic.net/en/docs/catalog): A scheduled feed, a file upload, and products learned from orders. Three feed formats, the price unit, and the id that produces no recommendations at all if it does not match your events.
- [Inbound webhooks and other services](https://segmentic.net/en/docs/webhooks): Taking events from a service that has no SDK, and the integrations that are ready.

## Engage customers

- [Building a segment, and what each condition means](https://segmentic.net/en/docs/segments): The condition language, every operator, and the main trap: a misspelled event name is not an error, it is an empty audience.
- [Building a journey](https://segmentic.net/en/docs/journeys): The graph each user walks alone: entry, waits, branches and exit.
- [Sending a transactional message](https://segmentic.net/en/docs/transactional): One message to one person, now: a login code, an order update, a payment reminder, with the idempotency contract that makes a retry safe.
- [Consent, unsubscribe and sending caps](https://segmentic.net/en/docs/consent): What can stop a send, and why that is a feature rather than an obstacle.
- [In-app messages and the inbox](https://segmentic.net/en/docs/onsite): Banners, modals and surveys inside a site or an app, and the inbox messages persist in.

## Analyze and export

- [Reports and exports](https://segmentic.net/en/docs/reports): Build funnels and retention reports, then import and export data safely from the panel.

## Developer reference

- [API reference](https://segmentic.net/en/docs/api): Two surfaces, two kinds of key, two hosts. This page says which job belongs to which.
- [Reference: the ingest endpoints](https://segmentic.net/en/docs/api/ingest): Every route on the ingest host, with a complete request and response you can copy.
- [Reference: the management API](https://segmentic.net/en/docs/api/management): Stable management routes for audiences, campaigns, journeys, reports and messages, with each required permission.
- [Error codes and what to do about them](https://segmentic.net/en/docs/errors): Every code that can come back, what it means, and whether to retry, fix something, or wait.
- [Limits and rate limiting](https://segmentic.net/en/docs/limits): Every number the server holds you to, and which of them you can ask the server for at runtime.
- [The OpenAPI document](https://segmentic.net/en/docs/openapi): A machine-readable description of both surfaces, for generating a client, testing, or feeding a tool.

## Developer tools

- [The MCP server: connecting Segmentic to an agent](https://segmentic.net/en/docs/mcp): A secure connection from AI agents to Segmentic data and tools.
- [Handing this documentation to Claude or Codex](https://segmentic.net/en/docs/ai): The single-file copy of these docs, and a ready prompt for saying «connect this service for me».

## Privacy and changes

- [Personal data: export and deletion](https://segmentic.net/en/docs/privacy): What to do when a person asks to see or delete their data, and what Segmentic does on its own.
- [API versioning and changes](https://segmentic.net/en/docs/versioning): What can change without notice, what cannot, and how a change to the API updates its own documentation.

## Guides, in Persian

- [اتوماسیون بازاریابی چیست](https://segmentic.net/marketing-automation): اتوماسیون بازاریابی یعنی برای هر کاربر جدا تصمیم بگیرید چه پیامی و از کدام کانال برسد. تعریف ساده، تفاوتش با ارسال انبوه، و اینکه در ایران چه چیزی عوض می‌شود.
- [ریتنشن مارکتینگ](https://segmentic.net/retention-marketing): ریتنشن مارکتینگ چیست و چطور به حفظ مشتری کمک می‌کند؟ با روش ساخت سناریو، انتخاب کانال مناسب و سنجش اثر واقعی پیام‌ها آشنا شوید.
- [نرخ حفظ مشتری](https://segmentic.net/customer-retention-rate): نرخ حفظ مشتری را با فرمول و محاسبه‌گر داخل صفحه حساب کنید و ببینید چرا مشتری‌های تازه نباید در این عدد شمرده شوند.
- [ارزش طول عمر مشتری](https://segmentic.net/customer-lifetime-value): ارزش طول عمر مشتری یا LTV را با محاسبه‌گر حساب کنید، با هزینه جذب مقایسه کنید و ببینید حاشیه سود چه اثری روی نتیجه دارد.
- [سبد خرید رها شده](https://segmentic.net/abandoned-cart): برای سبد خرید رها شده چه زمانی پیام بفرستیم و متن پیامک چه باشد؟ نمونه متن، ترتیب کانال‌ها و شرط توقف پیام‌ها را ببینید.
- [ارسال خودکار پیام](https://segmentic.net/automated-messaging): ارسال خودکار پیام در بله، ایتا و روبیکا چطور کار می‌کند؟ با تفاوت آن با ارسال انبوه، شرط شروع و محدودیت‌های ارسال آشنا شوید.
- [دسته‌بندی مشتریان](https://segmentic.net/customer-segmentation): دسته‌بندی رفتاری مشتریان و مدل RFM را بشناسید و یاد بگیرید چطور گروه‌هایی بسازید که با رفتار تازه مشتری‌ها به‌روز می‌شوند.
- [بازگشت مشتری](https://segmentic.net/win-back-customers): چطور مشتری از دست رفته را تشخیص دهیم، چه زمانی پیام بفرستیم و کجا تخفیف بدهیم؟ راهنمای ساخت یک سناریوی بازگشت قابل اندازه‌گیری.
- [تحلیل کوهورت](https://segmentic.net/cohort-analysis): تحلیل کوهورت چیست؟ روش خواندن جدول و منحنی نگهداشت را یاد بگیرید و افت واقعی کاربران را از تغییر ترکیب آن‌ها جدا کنید.
- [راهنماها](https://segmentic.net/guides): راهنماهای کاربردی سگمنتیک درباره نرخ ریزش، حفظ مشتری، ارزش طول عمر، سبد خرید رها شده، دسته‌بندی مشتریان و اتوماسیون بازاریابی.
- [نرخ ریزش مشتری](https://segmentic.net/customer-churn-rate): نرخ ریزش مشتری چیست، با چه فرمولی حساب می‌شود، بازهٔ زمانی را چطور انتخاب کنید، و دو اشتباهی که عدد را بی‌معنی می‌کند.

## Policies and terms, in Persian

> These are the published legal documents. They are the authoritative
> statement of what this company commits to, and they are rendered from
> versioned text rather than written on the page.

- [شرایط استفاده از خدمات | سگمنتیک](https://segmentic.net/terms): شرایط استفاده از خدمات سگمنتیک: دامنه خدمت، تعهدهای مشتری، تعلیق و فسخ، و قانون حاکم.
- [سیاست حریم خصوصی | سگمنتیک](https://segmentic.net/privacy): چه داده‌ای جمع می‌کنیم، کجا نگه می‌داریم، چه‌کسی به آن دسترسی دارد، و چطور حذفش می‌کنید.
- [سیاست ارسال پیام | سگمنتیک](https://segmentic.net/messaging-policy): چه پیامی نمی‌شود فرستاد، رضایت گیرنده چطور گرفته می‌شود، و نقض این سیاست چه پیامدی دارد.
- [سیاست کوکی و ذخیره‌سازی در مرورگر | سگمنتیک](https://segmentic.net/cookies): کیت توسعه و سایت سگمنتیک دقیقاً چه چیزی در مرورگر نگه می‌دارند و تا کی.
- [سند امنیت | سگمنتیک](https://segmentic.net/security): رمزنگاری، جداسازی مشتری‌ها، کنترل دسترسی، لاگ، پشتیبان، و محل نگهداری داده.
- [سیاست نسخه‌بندی رابط برنامه‌نویسی | سگمنتیک](https://segmentic.net/api-policy): چه چیزی تغییر شکننده حساب می‌شود، چقدر قبلش خبر می‌دهیم، و نسخه قدیمی چقدر زنده می‌ماند.
- [تعهدنامه سطح خدمات | سگمنتیک](https://segmentic.net/sla): تعهد در دسترس بودن، نحوه اندازه‌گیری، موارد خارج از شمول، و خدمات اعتباری.
- [شرایط دوره ارزیابی | سگمنتیک](https://segmentic.net/trial): دوره ارزیابی سگمنتیک چند روز است، چه محدودیتی دارد، و بعد از آن چه می‌شود.
- [سیاست لغو و بازگشت وجه | سگمنتیک](https://segmentic.net/refund): لغو اشتراک سگمنتیک وسط دوره چه می‌شود، چه مبلغی برمی‌گردد، در چه بازه‌ای پرداخت می‌شود، و کدام هزینه‌ها بازگشتی نیستند.

## Optional

- [OpenAPI document](https://segmentic.net/openapi.json): both HTTP surfaces, machine readable. Valid YAML as well as JSON.
- [Persian documentation](https://segmentic.net/docs): the same pages, in Persian, which is the original.
- [Persian single file](https://segmentic.net/docs-fa.md)