Skip to main content

Crossbow API Overview

The Crossbow API is designed for high-volume marketing campaigns using Meta’s Marketing Messages Lite API. It enables you to create, manage, and execute large-scale messaging campaigns with advanced flow control, rate limiting, and real-time monitoring.

What is Crossbow?

Crossbow is Plati AI’s campaign management system that integrates directly with Meta’s Marketing Messages Lite API (MM Lite API) to deliver optimized, high-volume messaging campaigns. It provides:
  • Campaign Management - Create and manage reusable campaign templates
  • Flow Execution - Execute message flows to thousands of contacts
  • Rate Limiting - Built-in rate limiting and pacing controls
  • Template Parameters - Dynamic parameter mapping with fallback strategies
  • Real-time Monitoring - Track execution status, statistics, and errors
  • Meta Integration - Direct integration with Meta MM Lite API for optimized delivery

Base URL

https://api.plati.ai

Key Concepts

Campaigns

Campaigns define reusable message templates and parameter strategies. They include:
  • Template name and configuration
  • Parameter mapping strategy
  • Channel association
  • Status management

Flows

Flows are execution instances of campaigns. They:
  • Send messages to multiple contacts
  • Handle rate limiting and pacing
  • Track delivery status
  • Provide real-time statistics

Template Parameters

Templates can include dynamic parameters that are filled from:
  • Contact associations (identity data)
  • Default values
  • Fallback chains

Authentication

Crossbow API uses the same authentication as Plati AI API. See Authentication for details.

Rate Limiting

Crossbow implements intelligent rate limiting:
  • Configurable pause between contacts
  • Random salt for natural pacing
  • Maximum concurrent messages
  • Retry logic with delays

Flow Status

Flows progress through these statuses:
  • draft - Created but not started
  • queued - Ready to execute
  • running - Currently executing
  • paused - Temporarily paused
  • completed - Successfully finished
  • partial_completed - Finished with some failures
  • cancelled - Manually cancelled
  • failed - Execution failed
  • error - Error occurred
  • timeout - Execution timeout

Next Steps