Send Instagram message

metaAds.sendInstagramMessage sends an Instagram direct text message from a professional account to one person.

automations/meta-ads-send-instagram-message.automation.ts

import { automation, onDashboardRun } from "automate.ax"
import { metaAds } from "automate.ax/meta-ads"

export default automation("Send Instagram message", () => {
  onDashboardRun({ title: "Send Instagram message" })
  metaAds.sendInstagramMessage({
    instagramAccountId: "instagram-account-id",
    recipientId: "instagram-scoped-id",
    text: "Your order is ready for pickup.",
  })
})

Find instagramAccountId with List Instagram accounts. Pass the person’s IGSID as recipientId; it’s senderId in On Instagram message received. Automate.ax sends through the Facebook Page linked to the Instagram account. text must be under 1,000 bytes. Meta accepts messages only inside the standard messaging window: 24 hours after the person’s last message or interaction, or up to 7 days after a Click-to-Instagram-Direct ad conversation starts. Optional second argument { account } selects a static project account binding. Returns recipientId and messageId. Sends aren’t replay-safe. The action needs instagram_basic, instagram_manage_messages, pages_read_engagement, and pages_show_list.

Built-in triggers

Built-in actions

Runtime utilities

Integrations

Send Instagram message