LINQ

Connecter PRX a iMessage, RCS, and SMS messaging via le Linq Partner V3 API for multi-protocol mobile messaging.

Prerequis

• A Linq Partner account with API access
• A Linq API token
• A phone number provisioned through Linq for sending messages

Quick Setup

1. Get API Credentials

1. Sign up pour un Linq Partner account at linqapp.com
2. Obtain your API Token depuis le partner dashboard
3. Nonte the phone number assigned to your account for sending

2. Configure

[channels_config.linq]
api_token = "your-linq-api-token"
from_phone = "+15551234567"
allowed_senders = ["+1987654321"]

3. Set Up Webhooks

Configure Linq to send webhook events to PRX's gateway endpoint:

POST https://your-prx-domain.com/linq

4. Verify

prx channel doctor linq

Configuration Reference

Champ	Type	Defaut	Description
api_token	String	required	Linq Partner API token (used as Bearer auth)
from_phone	String	required	Phone number to send from (E.164 format, e.g., "+15551234567")
signing_secret	String	null	Webhook signing secret for HMAC signature verification
allowed_senders	[String]	[]	Allowed sender phone numbers in E.164 format. "*" = allow all

Fonctionnalites

• Messagerie multi-protocole -- send and receive via iMessage, RCS, and SMS via un single integration
• Webhook-based delivery -- receives messages via HTTP webhook push from Linq
• Image support -- traite les pieces jointes d'images entrantes et les affiche comme marqueurs d'images
• Outbound/inbound detection -- automatically filters out your own outbound messages
• Signature verification -- optional HMAC webhook signature validation with signing_secret
• E.164 phone number filtering -- restrict access to specific sender phone numbers

Limiteations

• Requires a publicly accessible HTTPS endpoint for webhook delivery
• Linq Partner API access necessite a partner account (not a consumer account)
• Message delivery depend de the recipient's messaging protocol (iMessage, RCS, or SMS fallback)
• Only image MIME types are processed for inline attachments; other media types are skipped
• API rate limits depend on your Linq Partner tier

Depannage

Webhook events are not received

• Verify the webhook URL is publicly accessible and points to https://your-domain/linq
• Check the Linq partner dashboard for webhook delivery logs and errors
• Ensure the PRX gateway is running and listening sur le correct port

Messages sont envoyes but replies fail

• Verifiez que le api_token est valide et n'a pas expire
• Verifiez que from_phone is a valid, provisioned phone number on your Linq account
• Review the Linq API response for error details

Bot replies to its own messages

• This ne devrait pas happen; PRX automatiquement filters outbound messages using is_from_me and direction fields
• If it occurs, check that the webhook payload format matches the expected Linq V3 structure