API ارسال پیام روبیکا — یکپارچه‌سازی در ۵ دقیقه

روبیکا با اکوسیستم گسترده‌ای از کاربران ایرانی، یکی از جذاب‌ترین پلتفرم‌ها برای بازاریابی مستقیم است. در این مقاله یاد می‌گیرید چطور با API رباتپیام، ارسال پیام انبوه در روبیکا را در کمتر از ۵ دقیقه راه‌اندازی کنید.

پیش‌نیازها

• اکانت رباتپیام (ثبت‌نام رایگان در robatpayam.ir)
• یک شماره موبایل که در روبیکا فعال باشد
• Python 3.8+ یا هر زبان برنامه‌نویسی با قابلیت HTTP requests

گام ۱: دریافت API Key

پس از ورود به داشبورد رباتپیام، به بخش «API Keys» بروید و روی «ساخت API Key جدید» کلیک کنید. کلید ساخته‌شده را ذخیره کنید.

هشدار امنیتی: API Key را در کد سورس commit نکنید. از متغیر محیطی استفاده کنید:

import os
API_KEY = os.environ.get("ROBATPAYAM_API_KEY")

گام ۲: اتصال شماره‌ی روبیکا

در داشبورد، بخش «پلتفرم‌ها» → «اتصال روبیکا» را انتخاب کنید. کد تأیید به شماره ارسال می‌شود. پس از تأیید، شماره‌ی شما فعال می‌شود.

گام ۳: ارسال اولین پیام با API

import requests

API_KEY = "your-api-key-here"
BASE_URL = "https://robatpayam.ir/api/v1"

def send_message(phone, message):
    response = requests.post(
        f"{BASE_URL}/send",
        headers={"X-API-Key": API_KEY},
        json={
            "phone": phone,
            "platform": "Rubika",
            "message": message
        }
    )
    return response.json()

result = send_message("09121234567", "سلام! این پیام از طریق API ارسال شد")
print(result)

ارسال پیام انبوه (Bulk Send)

def send_bulk(phones, message):
    response = requests.post(
        f"{BASE_URL}/send-bulk",
        headers={"X-API-Key": API_KEY},
        json={
            "phones": phones,
            "platform": "Rubika",
            "message": message
        }
    )
    return response.json()

phones = ["09121234567", "09351234568", "09011234569"]
result = send_bulk(phones, "پیشنهاد ویژه‌ی امروز: ۳۰٪ تخفیف!")
print(result)

ارسال تصویر همراه با پیام

def send_image(phone, image_url, caption=""):
    response = requests.post(
        f"{BASE_URL}/send",
        headers={"X-API-Key": API_KEY},
        json={
            "phone": phone,
            "platform": "Rubika",
            "message": caption,
            "media_url": image_url,
            "media_type": "image"
        }
    )
    return response.json()

send_image("09121234567", "https://yourstore.com/catalog.jpg", "کاتالوگ محصولات جدید")

مدیریت خطاها

result = send_message(phone, message)

if result["success"]:
    print("پیام ارسال شد")
elif result["error"] == "SESSION_NOT_ACTIVE":
    print("سشن روبیکا منقضی شده")
elif result["error"] == "RATE_LIMIT":
    import time
    time.sleep(60)
    send_message(phone, message)

مثال کاربردی: تأیید سفارش خودکار

def notify_order(customer_phone, order_id, total):
    message = f"""سفارش شما ثبت شد!
شماره پیگیری: {order_id}
مبلغ: {total:,} تومان
پیگیری: robatpayam.ir/track/{order_id}"""
    return send_message(customer_phone, message)

notify_order("09121234567", "ORD-12345", 2500000)

محدودیت‌های API

مستندات کامل API در داشبورد رباتپیام در دسترس است.
ثبت‌نام رایگان و دریافت API Key ←