How It Works
- Secure Connection - Securely link your Plain workspace to Corsa. One-time setup with fully encrypted credential storage.
- Automatic Real-Time Syncing - Corsa receives real-time webhook notifications when conversations are created, messages are sent/received, or thread statuses change.
- Keeping Everything Up-to-Date - Status changes, new messages, and new conversations are all synced in real time.
Prerequisites
- A Plain account with permission to generate API credentials and configure webhooks.
- Owner access to the Corsa application.
Setting Up the Plain Integration
Step 1: Configure in Corsa
- Log in to Corsa.
- Go to Developers Hub → Integrations.
- Click Configure on the Plain card.
Step 2: Authentication
You will need:- Plain API Key with the required permissions:
attachment:download,attachment:read,company:read,customer:read,customerEmail:read,email:read,label:read,machineUser:read,thread:read,threadActivity:read,threadField:read,threadFieldSchema:read,timeline:read,user:read,workspace:read - Plain HMAC Secret
Step 3: Optional - Customer Card Configuration
Toggle the Customer Card option to display Corsa client details directly in the Plain sidebar. Available fields: Jurisdiction, Account Status, Risk Level, Client Type, Activity Status.Additional permissions required for customer cards:
customerCardConfig (create, delete, edit, read) and customerCardConfigApiDetails (edit, read).Step 4: Optional - Thread Fields Configuration
Toggle Thread Fields to auto-populate thread fields with Corsa client data. Available fields: Jurisdiction, Client Type, Country.Additional permissions required:
threadFieldSchema (create, delete, edit, read) and threadField (create, delete, update, read).Step 5: Configure Webhook in Plain
After saving, Corsa generates a webhook configuration. Set up the webhook in Plain with the provided URL and secret.Historical Conversation Import
Corsa can import historical conversations from Plain. Client matching uses:- Plain Customer ID (Direct Link): If already stored on the client record.
- Email Lookup (Automatic Matching): Corsa searches Plain using the client’s email address.
- Up to 10 threads per customer
- Conversations from the last 90 days
- All messages, statuses, and attachments within those threads
Automatic Client Matching
When a new conversation is received, Corsa links it to the correct client using the Plain Customer ID.If an individual client doesn’t have a Plain Customer ID but their email matches the customer’s email in Plain, the conversation will still sync. Corsa will automatically update the client record with the Plain Customer ID.
Corsa offers native integrations with leading compliance, blockchain analytics, and custody providers. See all integrations or schedule a demo to see how Corsa fits into your stack.