Skip to main content
POST
Надішліть нове пряме повідомлення отримувачу.
Ціни та ліміти: кожен User Profile може мати до 1 000 активних розмов за розрахунковий цикл у всіх соцмережах. Ціна залежить від вашого плану: плани Premium оплачують фіксований додаток 49/місяць,апланиLaunchтаBusinessтарифікуютьсяза49/місяць**, а плани **Launch** та **Business** тарифікуються за **0.09 за активну розмову. Розмова вважається активною, коли ви надсилаєте повідомлення отримувачу протягом розрахункового циклу; лише вхідні повідомлення не рахуються. Кількість повідомлень у межах активної розмови необмежена.
  • Ви можете надіслати emoji як частину тексту message.
  • mediaUrls для Facebook та Instagram мають закінчуватися відомим розширенням. Додавання параметрів запиту призведе до збою URL медіа.
24-годинне вікно обслуговування клієнтів WhatsApp. WhatsApp Business дозволяє надсилати вільні вихідні повідомлення лише протягом 24 годин після останнього повідомлення від кореспондента. Поза цим вікном Meta відхилятиме надсилання, доки кореспондент не напише знову. Шаблонні повідомлення поза 24-годинним вікном наразі не підтримуються через цей ендпоінт.

Параметри заголовка

Параметри шляху

string
обов'язково
Платформа для надсилання повідомлення: facebook, instagram, twitter, whatsapp

Параметри тіла

string
обов'язково
ID отримувача повідомлення.
  • Для Facebook, Instagram та X/Twitter це специфічний для платформи ID користувача (PSID, IGSID або user ID).
  • Для WhatsApp це номер телефону отримувача у форматі E.164, лише цифри (наприклад, 14155551234, а не +1 (415) 555-1234).
string
обов'язково
Повідомлення, яке надсилатиметься отримувачу.
  • Для Facebook, Instagram та WhatsApp message може бути порожнім рядком або не вказуватися взагалі, якщо надано mediaUrls.
  • X вимагає повідомлення довжиною щонайменше один символ, навіть якщо надано mediaUrls.
array
Масив URL медіа для прикріплення зображень, відео, аудіо (включно з голосовими повідомленнями) або документів.
  • URL медіа-елементів мають закінчуватися розширенням файлу без додаткових параметрів.
  • Facebook та Instagram підтримують кілька URL медіа.
  • X приймає лише один URL медіа.
  • Голосові повідомлення підтримуються у Facebook та Instagram як файл aac або wav.
  • WhatsApp приймає кілька URL медіа. Ayrshare отримує кожен URL і використовує його Content-Type у відповіді для вибору категорії медіа WhatsApp. Meta приймає:
    • Image: .jpg, .jpeg, .png
    • Video: .mp4, .3gp
    • Audio: .aac, .amr, .mp3, .m4a, .ogg
    • Document: .txt, .pdf, .ppt, .pptx, .doc, .docx, .xls, .xlsx