Ayrshare پیام رسانی API برای Facebook ، Instagram و X/Twitter

در دنیای برنامه ها و سیستم عامل های بازاریابی دیجیتال همیشه به دنبال ابزارهای جدیدی برای بهبود تعهد کاربران خود به سیستم عامل های خود هستند. سالهاست که Ayrshare در حال ارائه API پیشرو در رسانه های اجتماعی در صنعت برنامه ریزی انتشار ، استخراج تجزیه و تحلیل و مدیریت اظهار نظر است.

ما اکنون خوشحالیم که اولین ارائه ارتباطات خود را ارائه می دهیم: Ayrshare API برای پیام پیام های پیام-زمان مستقیم مدیریت پیام (DM) در Facebook Messenger ، پیام رسانی اینستاگرام و پیام های مستقیم X/Twitter.

بسیاری از مشتریان ما این فرصت را خواسته اند تا با پیام های واقعی با کاربران خود ارتباط برقرار کنند. برخی به یک گپ میز تعمیر و نگهداری نیاز دارند ، برخی دیگر برای ارسال اعلان ها به عنوان به روزرسانی سفارش و بیشتر اوقات برای حفظ فروش. اکنون با استفاده از پیام جدید API ، می توانید پیام های مستقیم کاربر خود را به کسانی که با آنها در کانال های مورد نظر خود ارتباط برقرار می کنند ، مدیریت کنید و به آنها امکان می دهد تجربه مشتری بدون درز را ارائه دهند. علاوه بر این ، راحتی استفاده از API برای مدیریت پیام ها در سیستم عامل های مختلف ، اجرای شما را بهینه می کند و تمام مزایای پلت فرم Ayrshare را دارد.

این راهنما با مثال کدها ، شما را از طریق ویژگی ها ، اجرای و برنامه های بالقوه پیام های API DM ترجمه می کند. اگر می خواهید به سرعت شروع به کار کنید ، می توانید از نسخه پیام GUI از برگه پیام های جدید در داشبورد مدیریت Ayrshare نیز استفاده کنید. این یک مثال عالی از چگونگی ادغام پیام ها در برنامه خود است.

استفاده از API برای پیام ها

پیام API برای ارائه خدمات پیام های مختلف از جمله ارسال و دریافت DMS از طریق چندین سیستم عامل اجتماعی در نظر گرفته شده است. این شامل ارسال پیام (از جمله متن ، تصاویر ، فیلم ها و ایموجی ها) ، دریافت پیام ، تنظیم پاسخ های خودکار و ثبت قلاب های وب برای اطلاع از پیام های جدید است.

1. مدیریت بحث

DM API به شما امکان می دهد با زحمت تماس بگیرید و تماس بگیرید و پیام ها را در چندین کانال دریافت کنید: پیام رسان فیس بوک ، پیام های اینستاگرام یا پیام مستقیم X.

استخراج پیام ها

با استفاده از نقطه پایان پیام های دریافت ، می توانید تمام پیام ها را برای یک پلتفرم خاص بیاورید. در اینجا مثالی با استفاده از CURL برای بازیابی DMS Facebook با استفاده از نقطه پایان API پیام ها آورده شده است:

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://app.ayrshare.com/api/messages/facebook

API داده های جامع از جمله:

• محتوای پیام
• برنامه ها (فیلم ها ، تصاویر)
• واکنش ها (به عنوان مثال لایک ، قلب)
• بازه زمانی
• اطلاعات تولید کننده و گیرنده

در اینجا نمونه ای از JSON Back:

{
    "status": "success",
    "messages": [
        {
            "senderId": "106638148652444",
            "senderDetails": {
                "name": "Ayrshare"
            },
            "conversationId": "t_10161117434308444",
            "created": "2024-06-06T00:54:32.455Z",
            "action": "sent",
            "recipientId": "7101149746568444",
            "id": "m_JH6o-yS83JoxWmQaLrmgSaHwGtfTgQ",
            "message": "Howdy!",
            "platform": "facebook",
            "reactions": {
                "7101149746568522": "😆". // Reaction by the customer on the Howdy! message
            }
        },
        {
            "senderId": "7101149746568444",
            "senderDetails": {
                "name": "John Smith",
                "profileImage": "https://platform-lookaside.fbsbx.com/platform/profilepic/"
            },
            "conversationId": "t_10161117434308444",
            "created": "2024-06-06T00:54:28.102Z",
            "action": "received",
            "recipientId": "106638148652329",
            "id": "m_HGbotYJUmf4AzyPlJ-2uZqHwGtfTgQihX",
            "message": "Look up!",
            "platform": "facebook"
        },
        {
            "senderId": "7101149746568444",
            "senderDetails": {
                "name": "John Smith",
                "profileImage": "https://platform-lookaside.fbsbx.com/platform/profilepic/"
            },
            "conversationId": "t_10161117434308444",
            "created": "2024-06-06T00:49:11.679Z",
            "action": "received",
            "recipientId": "106638148652444",
            "id": "m_jXoYQIwTXaq2u06PG6Z8vaHwGtfTgQ",
            "message": "How is the weather?",
            "platform": "facebook"
        }
    ],
    "lastUpdated": "2024-06-09T21:46:04.233Z",
    "nextUpdate": "2024-06-09T21:47:04.233Z"
}

بازیابی

بعضی اوقات شما نیاز به لیستی از مکالمات پلتفرم دارید. فقط به پارامتر مکالمه اضافه کنید = true. در اینجا مثالی وجود دارد اگر مکالمه اینستاگرام را در Node.js دریافت کنید:

const apiKey = 'API_KEY';
const url = 'https://app.ayrshare.com/api/messages/instagram?conversationsOnly=true';

const headers = {
  'Authorization': `Bearer ${apiKey}`,
};

fetch(url, {
  method: 'GET',
  headers: headers,
})
  .then(response => {
    if (response.ok) {
      return response.json();
    } else {
      throw new Error(`Request failed. Status code: ${response.status}`);
    }
  })
  .then(data => {
    console.log('Response:', data);
  })
  .catch(error => {
    console.error('Error:', error.message);
  });

و پاسخ JSON به شناسه های تماس:

{
    "status": "success",
    "conversationIds": [
        "t_10161117434308444",
        "t_356759043857444"
    ],
    "converstationsDetails": [
        {
            "id": "t_10161117434308444",
            "participant": {
                "name": "John Smith",
                "id": "7101149746568444",
                "picture": "https://platform-lookaside.fbsbx.com/platform/profilepic/"
            },
            "status": "active",
            "watermark": 1717889607444
        },
        {
            "id": "t_356759043857444",
            "participant": {
                "name": "Sara Johnson",
                "id": "7365320280173444",
                "picture": "https://platform-lookaside.fbsbx.com/platform/profilepic/"
            },
            "status": "active"
        }
    ],
    "lastUpdated": "2024-06-09T21:46:04.233Z",
    "nextUpdate": "2024-06-09T21:47:04.233Z"
}

2. ارسال پیام چندرسانه ای

پیام های پستی Endpoint به شما امکان می دهد تا با انواع مختلف محتوا ، از جمله پیامک و MMS ، پیام هایی را برای گیرندگان خود ارسال کنید. این شامل تصاویر ، GIF ها ، فیلم ها یا ایموجی ها است. در اینجا نمونه ای از JavaScript برای ارسال پیام تصویر به اینستاگرام DM با استفاده از نقطه پایان API پیام های ارسال شده است:

const apiKey = 'API_KEY';
const url = 'https://app.ayrshare.com/api/messages/instagram';

const data = {
  message: "What's up!",
  recipientId: '283j839222',
  "mediaUrl": ["img.ayrshare.com/012/gb.jpg"]
};

const headers = {
  'Authorization': `Bearer ${apiKey}`,
  'Content-Type': 'application/json',
};

fetch(url, {
  method: 'POST',
  headers: headers,
  body: JSON.stringify(data),
})
  .then(response => response.json())
  .then(data => {
    console.log('Response:', data);
  })
  .catch(error => {
    console.error('Error:', error);
  });

3. پاسخ های خودکار

یکی از ویژگی های مفید امکان تنظیم پاسخ های خودکار است. این تضمین می کند که کاربران شما همیشه تأیید سریع دریافت می کنند ، حتی اگر بلافاصله در دسترس نباشید. به عنوان مثال ، می توانید پاسخ دهید وقتی نمایندگان خدمات مشتری آنلاین نیستند یا یک رمز عبور یک را برای ارتباطات ایمن ارسال می کنند. در اینجا نحوه تنظیم آن با پایتون و نقطه پایان API برای تنظیم خودکار API برای پاسخ با “Howdy!” آورده شده است. و با تأخیر 1 ساعت قبل از پاسخ خودکار آن شخص دوباره ارسال می شود:

import json
import requests

url = 'https://app.ayrshare.com/api/messages/autoresponse'
headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer API_KEY'
}
data = {
    'autoResponseActive': True,
    'autoResponseWaitSeconds': 3600, // 1 hour before next auot response
    'autoResponseMessage': 'Howdy!'
}

response = requests.post(url, headers=headers, data=json.dumps(data))

try:
    response.raise_for_status()
    data = response.json()
    print(data)
except requests.exceptions.RequestException as e:
    print('Error:', e)

4. اعلان های زمان واقعی با وب سایت ها

با ثبت یک وب سایت پیام رسانی می توانید در بالای مکالمات خود در کانال های اجتماعی بمانید. برای فیس بوک و اینستاگرام ، می توانید Webhook را برای اقدامات پیام رسانی برای دریافت اعلان ها برای پیام های جدید ، خواندن رسیده یا واکنش ، ثبت کنید. انگشت شست در هر پیام. X به یک برنامه سطح بالاتر نیاز دارد ، بنابراین در صورت علاقه با ما تماس بگیرید.

در اینجا نمونه ای از بار مفید JSON که هنگام خواندن پیام دریافت خواهید کرد:

{
  "action": "messages",
  "code": 200,
  "conversationId": "t_10161117434308936",
  "created": "2024-06-08T23:33:30Z",
  "hookId": "CviPBMXEy3cdJnK0EESd",
  "mediaUrls": [],
  "platform": "facebook",
  "read": 1717889607802,
  "readerDetails": {
    "name": "John Smith",
    "id": "7101149746568444",
    "picture": "https://platform-lookaside.fbsbx.com/platform/profilepic"
  },
  "recipientId": "106638148652329",
  "refId": "9abf1426d6ce9122ef11c8932",
  "scheduleDate": "2024-06-08T23:33:30Z",
  "senderId": "7101149746568522",
  "subAction": "messageRead",
  "timeStamp": 1717889610,
  "title": "Primary Profile",
  "type": "read",
  "url": "https://mysite.com/webhook"
}

اجرای API در پیام های Ayrshare

مانند همه Ayrshare API ، می توانید به سرعت با API برای پیام های Ayrshare شروع کنید:

1. اطمینان حاصل کنید که اشتراک در برنامه تجاری Ayrshare دارید. اگر دیگر مشترک برنامه تجاری نیستید ، لطفا با ما تماس بگیرید.
2. پیام ها را در تنظیمات حساب خود در داشبورد فعال کنید. لطفاً توجه داشته باشید که پیام ها به صورت مکمل پرداخت می شوند.
3. برای فعال کردن پیام ها برای هر نمایه ، روی صفحه نمایه تمرکز کنید و روی جعبه پیام فعال کلیک کنید. کاربران برای فعال کردن پیام ها باید فیس بوک ، اینستاگرام و X را انتقال دهند.
4. اکنون آماده استفاده از API برای پیام ها هستید. کاربران شما اکنون می توانند از طریق کانال های مورد نظر خود با مشتریان ارتباط برقرار کنند.

همچنین می توانید با اضافه کردن پیام ها ، پیام های ایجاد پروفایل را برنامه ریزی کنید: درست به نقطه پایان حساب ها:

const API_KEY = "API_KEY";

fetch("https://app.ayrshare.com/api/profiles", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "Authorization": `Bearer ${API_KEY}`
      },
      body: JSON.stringify({
        title: "ACME Profile", // required
        messagingActive: true
      }),
    })
      .then((res) => res.json())
      .then((json) => console.log(json))
      .catch(console.error);

چرا یک API را برای پیام ها ادغام می کنیم؟

ادغام پیام رسانی Ayrshare API قابلیت ها و پیشنهادات خود را برای سیستم عامل شما باز می کند. در اینجا چند نمونه آورده شده است ، اما احتمالاً شما حتی برای تجارت خود نیز بهتر هستید.

1. پشتیبانی مشتری بهبود یافته: یک چت بابات را اعمال کنید که سوالات اولیه را پردازش می کند و در صورت لزوم هیچ مشکلی را به عوامل انسانی منتقل می کند. اینجاست که پاسخ پیام خودکار بسیار مفید است.
2. بازاریابی سفارشی: توصیه هایی را برای محصولات هدفمند بر اساس تعامل و ترجیحات مصرف کننده ارسال کنید.
3. اعلان های خودکار: کاربران را از وضعیت سفارش ، به روزرسانی حساب یا رویدادهای آینده مطلع کنید.
4. رهبری: یک قیف پیام ایجاد کنید که مشتریان بالقوه را از طریق فرآیند فروش اداره می کند. ما خودمان از این استفاده می کنیم!
5. مدیریت جامعه: با مخاطبان خود در چندین سیستم عامل از یک رابط درگیر شوید.
6. تجربیات شخصی: برای بهبود تعهد کاربران ، تعامل و محتوای شخصی ، مانند سیگنال ها ، یادآوری ها و اعلان ها را ارائه دهید.

Ayrshare API برای پیام ها روشی خارق العاده برای ارائه پیام با سیستم عامل متقاطع است. با ارائه یک رابط یکپارچه برای Facebook Messenger ، پیام رسانی اینستاگرام و پیام رسانی مستقیم X/Twitter ، کسب و کار شما می تواند قابلیت های ارتباطی جذاب ، پاسخگو و شخصی تر ایجاد کند.

ما از گزینه های جدید API API برای Ayrshare بسیار هیجان زده هستیم و ما در اینجا هستیم تا به عنوان یکپارچه به شما کمک کنیم. برای کسب اطلاعات بیشتر در مورد کلیه محصولات Ayrshare ، مستندات و نگهداری دقیق ، به وب سایت Ayrshare مراجعه کنید.