Channels

const response = await fetch('https://api.heylua.ai/developer/agents/<<YOUR_AGENT_ID>>/channels/send', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <<YOUR_API_KEY>>',
    'Content-Type': 'application/json',
    'X-Idempotency-Key': 'order-1042-shipped',
  },
  body: JSON.stringify({ channel: 'whatsapp', to: { phoneNumber: '+15551234567' }, text: 'Your order 1042 has shipped.' }),
});
const sent: { deliveryId: string; status: string; queued?: boolean } = await response.json();
console.log(sent.deliveryId, sent.status);

curl -X POST "https://api.heylua.ai/developer/agents/<<YOUR_AGENT_ID>>/channels/send" \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: order-1042-shipped" \
  -d '{ "channel": "whatsapp", "to": { "phoneNumber": "+15551234567" }, "text": "Your order 1042 has shipped." }'

const response = await fetch('https://api.heylua.ai/developer/agents/<<YOUR_AGENT_ID>>/channels/whatsapp/template', {
  method: 'POST',
  headers: { Authorization: 'Bearer <<YOUR_API_KEY>>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    to: { phoneNumber: '+15551234567' },
    templateName: 'order_update',
    languageCode: 'en_US',
    components: [{ type: 'body', parameters: [{ type: 'text', text: '1042' }] }],
    messageContext: 'Order 1042 update sent',
  }),
});
const sent: { deliveryId: string; status: string } = await response.json();
console.log(sent.status);

curl -X POST "https://api.heylua.ai/developer/agents/<<YOUR_AGENT_ID>>/channels/whatsapp/template" \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Content-Type: application/json" \
  -d '{
    "to": { "phoneNumber": "+15551234567" },
    "templateName": "order_update",
    "languageCode": "en_US",
    "components": [{ "type": "body", "parameters": [{ "type": "text", "text": "1042" }] }],
    "messageContext": "Order 1042 update sent"
  }'

const response = await fetch('https://api.heylua.ai/developer/agents/<<YOUR_AGENT_ID>>/channels/whatsapp/reaction', {
  method: 'POST',
  headers: { Authorization: 'Bearer <<YOUR_API_KEY>>', 'Content-Type': 'application/json' },
  body: JSON.stringify({ to: { phoneNumber: '+15551234567' }, messageId: 'wamid.HBgL...', emoji: '👍' }),
});
const sent: { deliveryId: string } = await response.json();
console.log(sent.deliveryId);

curl -X POST "https://api.heylua.ai/developer/agents/<<YOUR_AGENT_ID>>/channels/whatsapp/reaction" \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Content-Type: application/json" \
  -d '{ "to": { "phoneNumber": "+15551234567" }, "messageId": "wamid.HBgL...", "emoji": "👍" }'

const response = await fetch('https://api.heylua.ai/developer/agents/<<YOUR_AGENT_ID>>/channels/whatsapp/phone-request', {
  method: 'POST',
  headers: { Authorization: 'Bearer <<YOUR_API_KEY>>', 'Content-Type': 'application/json' },
  body: JSON.stringify({ to: { userId: 'user_abc123' }, text: 'To book a table, please share your phone number.' }),
});
const sent: { deliveryId: string } = await response.json();
console.log(sent.deliveryId);

curl -X POST "https://api.heylua.ai/developer/agents/<<YOUR_AGENT_ID>>/channels/whatsapp/phone-request" \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Content-Type: application/json" \
  -d '{ "to": { "userId": "user_abc123" }, "text": "To book a table, please share your phone number." }'

const response = await fetch('https://api.heylua.ai/developer/agents/<<YOUR_AGENT_ID>>/channels/email/send', {
  method: 'POST',
  headers: { Authorization: 'Bearer <<YOUR_API_KEY>>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    to: { email: '[email protected]' },
    subject: 'Your invoice for order 1042',
    richBody: 'Thanks for your order. Your invoice is attached.',
    attachments: [
      { filename: 'invoice-1042.pdf', contentType: 'application/pdf', url: 'https://example.com/invoices/1042.pdf' },
    ],
  }),
});
const sent: { deliveryId: string; messageId?: string } = await response.json();
console.log(sent.messageId);

curl -X POST "https://api.heylua.ai/developer/agents/<<YOUR_AGENT_ID>>/channels/email/send" \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Content-Type: application/json" \
  -d '{
    "to": { "email": "[email protected]" },
    "subject": "Your invoice for order 1042",
    "richBody": "Thanks for your order. Your invoice is attached.",
    "attachments": [{ "filename": "invoice-1042.pdf", "contentType": "application/pdf", "url": "https://example.com/invoices/1042.pdf" }]
  }'

const params = new URLSearchParams({ status: 'failed', since: '2026-09-01T00:00:00Z', limit: '50' });
const response = await fetch(`https://api.heylua.ai/developer/agents/<<YOUR_AGENT_ID>>/channels/deliveries?${params}`, {
  headers: { Authorization: 'Bearer <<YOUR_API_KEY>>' },
});
const { data }: { data: Array<{ id: string; status: string; error?: { category: string; title: string } }> } =
  await response.json();
for (const delivery of data) console.log(delivery.id, delivery.error?.category, delivery.error?.title);

curl "https://api.heylua.ai/developer/agents/<<YOUR_AGENT_ID>>/channels/deliveries?status=failed&since=2026-09-01T00:00:00Z&limit=50" \
  -H "Authorization: Bearer <<YOUR_API_KEY>>"

const response = await fetch('https://api.heylua.ai/developer/agents/<<YOUR_AGENT_ID>>/channels/deliveries/<<DELIVERY_ID>>', {
  headers: { Authorization: 'Bearer <<YOUR_API_KEY>>' },
});
const { data }: { data: { status: string; deliveredAt?: string; readAt?: string } } = await response.json();
console.log(data.status, data.readAt);

curl "https://api.heylua.ai/developer/agents/<<YOUR_AGENT_ID>>/channels/deliveries/<<DELIVERY_ID>>" \
  -H "Authorization: Bearer <<YOUR_API_KEY>>"