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
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 startedqueued- Ready to executerunning- Currently executingpaused- Temporarily pausedcompleted- Successfully finishedpartial_completed- Finished with some failurescancelled- Manually cancelledfailed- Execution failederror- Error occurredtimeout- Execution timeout
