import type { TriggerOutput } from '@/triggers/types'
export const sendblueTriggerOptions = [
{ label: 'Message Received', id: 'sendblue_message_received' },
{ label: 'Message Status Updated', id: 'sendblue_message_status_updated' },
]
export function sendblueSetupInstructions(eventType: string): string {
const instructions = [
'Copy the Webhook URL above.',
'Open your Sendblue dashboard and go to Settings > Webhooks.',
eventType === 'Message Received'
? 'Paste the Webhook URL into the Receive Webhook field to receive inbound messages.'
: 'Paste the Webhook URL into the Send / Status Webhook field to receive outbound message status updates. You can also pass it per-message as the status_callback parameter.',
'Save your webhook settings in Sendblue.',
]
return instructions
.map(
(instruction, index) =>
`
${index + 1}. ${instruction}
`
)
.join('')
}
/**
* Outputs shared by both Sendblue message webhooks. Inbound and outbound
* status callbacks use the same payload schema.
*/
export function buildSendblueOutputs(): Record {
return {
account_email: { type: 'string', description: 'Email of the Sendblue account' },
content: { type: 'string', description: 'Message text content' },
media_url: { type: 'string', description: 'CDN link to attached media, if any' },
is_outbound: { type: 'boolean', description: 'True for outbound messages, false for inbound' },
status: {
type: 'string',
description: 'Message status (e.g., RECEIVED, QUEUED, SENT, DELIVERED, ERROR)',
},
error_code: { type: 'number', description: 'Error identifier, null if none' },
error_message: { type: 'string', description: 'Descriptive error text, null if none' },
error_reason: { type: 'string', description: 'Additional error context, null if none' },
error_detail: { type: 'string', description: 'Detailed error information, null if none' },
message_handle: {
type: 'string',
description: 'Sendblue message identifier (use to deduplicate)',
},
date_sent: { type: 'string', description: 'ISO 8601 creation timestamp' },
date_updated: { type: 'string', description: 'ISO 8601 last-update timestamp' },
from_number: { type: 'string', description: 'E.164 sender phone number' },
number: { type: 'string', description: 'E.164 recipient/counterparty phone number' },
to_number: { type: 'string', description: 'E.164 destination phone number' },
was_downgraded: {
type: 'boolean',
description: 'True if the recipient lacks iMessage support',
},
plan: { type: 'string', description: 'Account plan type' },
message_type: { type: 'string', description: 'Message category (e.g., message, group)' },
group_id: { type: 'string', description: 'Group identifier, null for non-group messages' },
participants: { type: 'array', description: 'Participant phone numbers for group messages' },
send_style: { type: 'string', description: 'Expressive style if applied' },
opted_out: { type: 'boolean', description: 'True if the recipient has opted out' },
sendblue_number: { type: 'string', description: 'Sendblue phone number used' },
service: { type: 'string', description: 'Messaging service (iMessage or SMS)' },
group_display_name: {
type: 'string',
description: 'Group chat name, null for non-group messages',
},
sender_email: { type: 'string', description: 'Email of the user who sent the message' },
seat_id: { type: 'string', description: 'Seat UUID, null if absent' },
raw: {
type: 'string',
description: 'Complete raw webhook payload from Sendblue as a JSON string',
},
}
}