Skip to main content
POST
Gửi một tin nhắn trực tiếp mới đến người nhận.
Định giá & Giới hạn: Mỗi User Profile có thể có tối đa 1.000 cuộc trò chuyện đang hoạt động mỗi chu kỳ thanh toán trên tất cả các mạng xã hội. Định giá tùy thuộc vào gói của bạn: Các gói Premium trả phí cố định 49mo^~ithaˊngnhưtinıˊchbsung,trongkhicaˊcgoˊiLaunchvaˋBusinessđượctıˊnhphıˊ49 mỗi tháng** như tiện ích bổ sung, trong khi các gói **Launch** và **Business** được tính phí **0,09 cho mỗi cuộc trò chuyện đang hoạt động. Một cuộc trò chuyện được tính là đang hoạt động khi bạn gửi tin nhắn cho người nhận trong chu kỳ thanh toán; các tin nhắn đến một mình không được tính. Số lượng tin nhắn trong một cuộc trò chuyện đang hoạt động là không giới hạn.
  • Bạn có thể gửi emoji như một phần của văn bản message.
  • Các mediaUrls của Facebook và Instagram phải kết thúc bằng một phần mở rộng đã biết. Việc bao gồm các tham số truy vấn sẽ khiến url media thất bại.
Cửa sổ chăm sóc khách hàng 24 giờ của WhatsApp. WhatsApp Business chỉ cho phép các tin nhắn đi (outbound) dạng free-form trong vòng 24 giờ kể từ tin nhắn gần nhất của người liên lạc. Sau cửa sổ đó, các lần gửi tin nhắn sẽ bị Meta từ chối cho đến khi người liên lạc nhắn tin lại. Các tin nhắn templated ngoài cửa sổ 24 giờ hiện chưa được hỗ trợ thông qua endpoint này.

Tham số Header

Tham số Path

string
bắt buộc
Nền tảng để gửi tin nhắn: facebook, instagram, twitter, whatsapp

Tham số Body

string
bắt buộc
ID của người nhận tin nhắn.
  • Đối với Facebook, Instagram, và X/Twitter đây là user ID theo nền tảng (PSID, IGSID, hoặc user ID).
  • Đối với WhatsApp đây là số điện thoại của người nhận theo định dạng E.164 chỉ chữ số (ví dụ 14155551234, không phải +1 (415) 555-1234).
string
bắt buộc
Tin nhắn để gửi cho người nhận.
  • message của Facebook, Instagram và WhatsApp có thể là chuỗi rỗng hoặc bị bỏ qua hoàn toàn khi mediaUrls được cung cấp.
  • X yêu cầu một tin nhắn có ít nhất một ký tự ngay cả khi mediaUrls được cung cấp.
array
Mảng các URL media để đính kèm hình ảnh, video, audio (bao gồm tin nhắn thoại) hoặc tài liệu.
  • Các URL của các mục media phải kết thúc bằng phần mở rộng tệp mà không có tham số bổ sung nào được thêm vào.
  • Facebook và Instagram hỗ trợ nhiều URL media.
  • X chỉ chấp nhận một URL media duy nhất.
  • Tin nhắn thoại được hỗ trợ trên Facebook và Instagram dưới dạng tệp aac hoặc wav.
  • WhatsApp chấp nhận nhiều URL media. Ayrshare tải mỗi URL và sử dụng Content-Type phản hồi của nó để chọn danh mục media WhatsApp. Meta chấp nhận:
    • Image: .jpg, .jpeg, .png
    • Video: .mp4, .3gp
    • Audio: .aac, .amr, .mp3, .m4a, .ogg
    • Document: .txt, .pdf, .ppt, .pptx, .doc, .docx, .xls, .xlsx