Рассылки

curl -X POST https://api.aisar.app/v1/broadcasts \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "February promo",
    "is_draft": false,
    "audience": { "segmentId": "12" },
    "channels": { "mode": "specific", "channelIds": [7] },
    "content": {
      "channels": [
        { "type": "text", "channelId": 7, "accountType": "whatsapp", "text": "Hi {{first_name}}, 20% off this week!" }
      ]
    },
    "schedule": { "mode": "now" }
  }'

{
  "data": {
    "id": 88,
    "company_id": 1,
    "name": "February promo",
    "status": "active",
    "audience": {
      "conditions": [],
      "group_logic": "and"
    },
    "channels": [{ "id": 7, "mode": "specific" }],
    "content": [],
    "schedule": { "mode": "now", "scheduledAt": null },
    "recurring_schedule": null,
    "runs": [
      { "id": 201, "broadcast_id": 88, "status": "processing", "total": 340, "sent": 0, "failed": 0, "delivered": 0, "read": 0, "started_at": "2026-03-15T10:00:00.000000Z", "completed_at": null }
    ],
    "created_at": "2026-03-15T10:00:00.000000Z",
    "updated_at": "2026-03-15T10:00:00.000000Z"
  }
}

curl -X POST https://api.aisar.app/v1/broadcasts/estimate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "segment_id": 12,
    "channel_ids": [7]
  }'

{
  "data": {
    "total_contacts": 340,
    "reachable_contacts": 312,
    "excluded_contacts": 28,
    "estimated_duration_seconds": 312,
    "estimated_completion": "2026-03-15T10:05:12.000Z"
  }
}

curl -X POST https://api.aisar.app/v1/broadcasts \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Spring reactivation",
    "is_draft": true,
    "audience": { "segmentId": "12" },
    "channels": { "mode": "specific", "channelIds": [7] },
    "content": {
      "channels": [
        {
          "type": "text",
          "channelId": 7,
          "accountType": "whatsapp",
          "text": "Hi {{first_name}}, we miss you!",
          "variants": [
            { "key": "A", "text": "Hi {{first_name}}, we miss you — here is 15% off." },
            { "key": "B", "text": "{{first_name}}, come back for 15% off this week." }
          ]
        }
      ],
      "settings": {
        "trackClicks": true,
        "includeOptOut": true,
        "optOutText": "Reply STOP to unsubscribe"
      }
    },
    "schedule": {
      "mode": "later",
      "scheduledAt": "2026-04-01T09:00:00Z",
      "rateControl": {
        "enabled": true,
        "messagesPerMinute": 30,
        "jitterMinSeconds": 2,
        "jitterMaxSeconds": 8,
        "dailyLimit": 5000,
        "skipContactedWithinHours": 48
      },
      "sendWindow": {
        "enabled": true,
        "mode": "smart",
        "startTime": "09:00",
        "endTime": "20:00",
        "timezone": "recipient"
      }
    }
  }'

{
  "data": {
    "id": 89,
    "company_id": 1,
    "name": "Spring reactivation",
    "status": "draft",
    "audience": { "conditions": [], "group_logic": "and" },
    "channels": [{ "id": 7, "mode": "specific" }],
    "content": [],
    "schedule": { "mode": "later", "scheduledAt": "2026-04-01T09:00:00.000000Z" },
    "recurring_schedule": null,
    "runs": [],
    "created_at": "2026-03-20T12:00:00.000000Z",
    "updated_at": "2026-03-20T12:00:00.000000Z"
  }
}

curl -X POST https://api.aisar.app/v1/broadcasts/89/publish \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "data": {
    "id": 89,
    "status": "scheduled",
    "schedule": { "mode": "later", "scheduledAt": "2026-04-01T09:00:00.000000Z" },
    "runs": [],
    "updated_at": "2026-03-20T12:05:00.000000Z"
  }
}

curl -X POST https://api.aisar.app/v1/broadcasts/90/run \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "data": {
    "message": "Channel \"WhatsApp Main\" has no approved template \"spring_promo\" (language ru). Approve this template for the channel or pick a channel where it is approved.",
    "errors": {
      "content": [
        "Channel \"WhatsApp Main\" has no approved template \"spring_promo\" (language ru). Approve this template for the channel or pick a channel where it is approved."
      ]
    }
  }
}

curl -X POST https://api.aisar.app/v1/broadcasts/test \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": 7,
    "recipient": "+12025550102",
    "content": { "type": "text", "text": "Test: 15% off this week!" }
  }'

{
  "data": {
    "message": "Test message queued.",
    "message_id": "b1f2c3d4-EXAMPLE"
  }
}

curl -X POST https://api.aisar.app/v1/broadcasts/assist \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "improve",
    "text": "hey buy our stuff now big sale",
    "locale": "en"
  }'

{
  "data": {
    "text": "Big news, {{first_name}} — our best sale of the season is live. Save 20% this week only.",
    "action": "improve",
    "tokens_used": 128
  }
}

curl "https://api.aisar.app/v1/broadcasts/89/messages?status=failed&per_page=2" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "data": [
    {
      "id": 7001,
      "contact_id": 123,
      "identifier": "+7700000XXXX",
      "status": "failed",
      "error_message": "recipient_not_on_whatsapp",
      "attempts": 2,
      "variant_key": "A",
      "delivered_at": null,
      "read_at": null,
      "replied_at": null,
      "clicked_at": null,
      "contact": { "id": 123, "display_name": "Aylin Weber", "first_name": "Aylin", "last_name": "Weber" },
      "channel": { "id": 7, "name": "WhatsApp Main" }
    },
    {
      "id": 7002,
      "contact_id": 124,
      "identifier": "+7700000YYYY",
      "status": "failed",
      "error_message": "message_send_timeout",
      "attempts": 3,
      "variant_key": "B",
      "delivered_at": null,
      "read_at": null,
      "replied_at": null,
      "clicked_at": null,
      "contact": { "id": 124, "display_name": "Marco Ricci", "first_name": "Marco", "last_name": "Ricci" },
      "channel": { "id": 7, "name": "WhatsApp Main" }
    }
  ],
  "meta": { "current_page": 1, "last_page": 1, "per_page": 2, "total": 2 }
}

curl -X POST https://api.aisar.app/v1/broadcasts/89/runs/201/retry-failed \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "data": {
    "id": 201,
    "broadcast_id": 89,
    "status": "processing",
    "total": 340,
    "sent": 300,
    "failed": 0,
    "delivered": 280,
    "read": 190,
    "started_at": "2026-04-01T09:00:00.000000Z",
    "completed_at": null
  }
}

curl -X GET https://api.aisar.app/v1/broadcasts/90 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "data": {
    "id": 90,
    "status": "failed",
    "logs": [
      {
        "level": "warning",
        "event": "run_failed",
        "message": "WhatsApp Business account \"WhatsApp Main\" cannot send messages: There has been an error processing your payment method. (Meta error 131042)",
        "timestamp": "2026-09-09T08:15:44.000000Z"
      }
    ],
    "runs": [
      { "id": 305, "broadcast_id": 90, "status": "failed", "total": 0, "sent": 0, "failed": 0, "delivered": 0, "read": 0, "started_at": "2026-09-09T08:15:44.000000Z", "completed_at": "2026-09-09T08:15:44.000000Z" }
    ],
    "updated_at": "2026-09-09T08:15:44.000000Z"
  }
}

curl -X POST https://api.aisar.app/v1/broadcasts \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Price list",
    "is_draft": true,
    "audience": { "segmentId": "12" },
    "channels": { "mode": "specific", "channelIds": [7] },
    "content": {
      "channels": [
        {
          "type": "text",
          "channelId": 7,
          "accountType": "whatsapp",
          "text": "Hi {{first_name}}, here is our new price list.",
          "attachments": [
            { "id": "att_1", "type": "document", "name": "price-list.pdf", "media_id": "med_9f3a2b7c" }
          ]
        }
      ]
    },
    "schedule": { "mode": "later", "scheduledAt": null }
  }'

{
  "data": {
    "id": 91,
    "company_id": 1,
    "name": "Price list",
    "status": "draft",
    "content": {
      "channels": [
        {
          "type": "text",
          "channelId": 7,
          "accountType": "whatsapp",
          "text": "Hi {{first_name}}, here is our new price list.",
          "attachments": [
            { "id": "att_1", "type": "document", "name": "price-list.pdf", "media_asset_id": 5120 }
          ]
        }
      ]
    },
    "runs": [],
    "created_at": "2026-09-23T10:00:00.000000Z",
    "updated_at": "2026-09-23T10:00:00.000000Z"
  }
}

curl "https://api.aisar.app/v1/broadcasts/meta" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "data": {
    "segments": [
      { "id": "12", "name": "Active customers", "size": 340, "channels": [7] }
    ],
    "variables": [
      { "key": "first_name", "displayName": "First name" },
      { "key": "order_number", "displayName": "Order number" }
    ],
    "templates": [
      {
        "id": "15",
        "name": "Appointment reminder",
        "category": "utility",
        "content": "Здравствуйте, {{first_name}}! Напоминаем о записи {{appointment_at}}.",
        "channel_type": "whatsapp_business",
        "status": "published",
        "variables": ["first_name", "appointment_at"],
        "header_enabled": true,
        "header_type": "text",
        "header_media_url": null,
        "header_media": null
      },
      {
        "id": "20",
        "name": "Promotion with image",
        "category": "marketing",
        "content": "Здравствуйте, {{first_name}}! Ознакомьтесь с нашим новым каталогом.",
        "channel_type": "whatsapp_business",
        "status": "published",
        "variables": ["first_name"],
        "header_enabled": true,
        "header_type": "image",
        "header_media_url": null,
        "header_media": {
          "media_id": "med_01arc7z0z0000000001234567",
          "filename": "catalog-march-2026.jpg",
          "mime_type": "image/jpeg",
          "size": 2457600,
          "preview_url": "https://api.aisar.app/v1/media/template-header/01ARC7Z0Z0000000001234567?company=42&expires=1791180000&signature=…"
        }
      }
    ]
  }
}

curl -X PATCH https://api.aisar.app/v1/broadcasts/91 \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": {
      "channels": [
        {
          "type": "text",
          "channelId": 7,
          "accountType": "whatsapp",
          "text": "Hi {{first_name}}, here is our new price list.",
          "attachments": [
            { "id": "att_2", "type": "document", "name": "report.pdf", "storage_disk": "local", "storage_path": "99/attachments/0b7e5d1a-3c2f-4a8e-9d10-2e3f4a5b6c7d.pdf" }
          ]
        }
      ]
    }
  }'

{
  "data": {
    "message": "Attachment source is invalid or does not belong to the current company.",
    "errors": {
      "content.channels.0.attachments.0": [
        "Attachment source is invalid or does not belong to the current company."
      ]
    }
  }
}