Charchy Senddocs

نامەبەر

ئیمەیڵی مامەڵەیی بۆ ئەپەکەت — کۆدی چوونەژوورەوە، گۆڕینی وشەی نهێنی، پسووڵە و نوێکارییەکانی داواکاری — لە دۆمەینی خۆتەوە دەنێردرێت.

نامەبەر (بە ئینگلیزی Charchy Send) API ـیەکی ئیمەیڵە. سێرڤەرەکەت داوایەک بۆ یەک ناونیشان دەنێرێت و ئیمەیڵەکە لە دۆمەینی خۆتەوە دەڕوات، واژۆکراو بە کلیلی DKIM ـی دۆمەینەکەت. قۆناغەکانی هەر ئیمەیڵێک لە داشبۆرددا دەبینیت و سێرڤەرەکەت بە webhook ـی واژۆکراو ئاگادار دەکرێتەوە.

import { CharchySend } from "@charchy/send"

const send = new CharchySend() // reads CHARCHY_SEND_KEY

await send.emails.send(
  {
    from: "دارین گەیم <hello@daringaming.com>",
    to: "customer@example.com",
    subject: "کۆدی چوونەژوورەوەت: 482910",
    text: "کۆدەکەت 482910 ـە. دوای ١٠ خولەک بەسەردەچێت.",
  },
  { idempotencyKey: "signin-code/1842" }
)

بۆ چییە

ئیمەیڵی مامەڵەیی — ئەو ئیمەیڵانەی بەهۆی کردارێکی خودی کەسەکە یان هەژمارەکەیەوە دەنێردرێن:

  • کۆدی چوونەژوورەوە و پشتڕاستکردنەوە
  • گۆڕینی وشەی نهێنی
  • پسووڵە و فاتورە
  • پشتڕاستکردنەوەی داواکاری، گەیاندن و حجزکردن
  • ئاگادارکردنەوەکانی هەژمار

هەواڵنامە، ئۆفەر و ڕاگەیاندن بازاڕگەرین و لە ڕێگەی کەمپەینەکانی چارچییەوە دەنێردرێن، نەک ئەم API ـیە. بۆ زانینی جیاوازیی نێوانیان، سەیری ناردنی ئیمەیڵ (بە ئینگلیزی) بکە.

بۆچی نامەبەر

  • کوردی و عەرەبی بێ کێشە کار دەکەن — لە بابەت، ناوەڕۆک و ناوی پیشاندراوی نێرەردا ("دارین گەیم <hello@daringaming.com>").
  • بۆ ئەو کۆدانە دروستکراوە کە کاتیان بەسەردەچێت. expires_at دیاری بکە؛ ئەگەر ئیمەیڵەکە نەتوانێت لە کاتی خۆیدا بنێردرێت، لای دەبەین و پارەکەی دەگەڕێنینەوە. کۆدێکی چوونەژوورەوە کە ٢٠ خولەک دوابکەوێت، لە نەگەیشتنی خراپترە.
  • دۆخی تاقیکردنەوەی خۆڕایی. بە کلیلی تاقیکردنەوە و ناونیشانە تایبەتەکانی @sim.charchy.krd دەتوانیت دروست بکەیت و CI کارپێبکەیت — بێ ناردنی ئیمەیڵی ڕاستەقینە و بێ خەرجکردنی کرێدیت.
  • نرخی کەمتر لە قەبارەی زۆردا. نرخەکان لە ٩ دۆلارەوە لە مانگێکدا دەست پێدەکەن.

چۆن کار دەکات

  1. دۆمەینەکەت زیاد بکە لە داشبۆرددا و سێ تۆماری DNS بڵاو بکەرەوە (یان کرتە لە Add with Cloudflare بکە). دۆمەینەکان و DNS
  2. کلیلێکی API دروست بکە. کلیلی تاقیکردنەوە بە chy_test_ دەست پێدەکات و کلیلی ڕاستەقینە بە chy_live_. تەنها لەسەر سێرڤەر — هەرگیز لە کۆدی وێبگەڕ یان ئەپی مۆبایلدا بەکاری مەهێنە.
  3. بنێرە بە POST /v1/emails، یان تا ١٠٠ ئیمەیڵ بەیەکەوە بە POST /v1/emails/batch.
  4. بەدواداچوون بکە بۆ email.delivered، email.bounced و ڕووداوەکانی تری webhook، یان قۆناغەکانی ئیمەیڵێک بخوێنەوە بە GET /v1/emails/{id}.

وەرگرتنی دەستگەیشتن

نامەبەر ئێستا تەنها بە بانگهێشتە: هەر کڕیارێک خۆمان ڕێکی دەخەین و پێش ئەوەی دەست بە ناردنی ڕاستەقینە بکەیت، دۆمەینەکەت و یەکەم ئیمەیڵەکانت دەپشکنین. داوای دەستگەیشتن بکە — ماڵپەڕەکەت، ئەو ئیمەیڵانەی ئەپەکەت دەیاننێرێت و ژمارەی ئیمەیڵی مانگانە. داواکارییە پەسەندکراوەکان بانگهێشتێک بە ئیمەیڵ وەردەگرن. دۆخی تاقیکردنەوە لە کاتی دروستکردندا بەخۆڕاییە.

بەڵگەنامە تەکنیکییەکان بە ئینگلیزین: دەستپێکی خێرا · ناردنی ئیمەیڵ · Webhooks · API reference.

On this page