Chat Integration

curl -X POST https://api.velora.tv/api/integrations/oauth/chat/channels/user-uuid-123/messages \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hello from my integration!",
    "effect": "glow",
    "effectColor": "#ff6b6b"
  }'

{
  "success": true,
  "messageId": "msg-uuid-456"
}

curl -X POST https://api.velora.tv/api/integrations/oauth/chat/channels/user-uuid-123/messages \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Thanks for the follow!",
    "replyTo": {
      "messageId": "original-msg-uuid",
      "username": "newviewer",
      "snippet": "Just followed, love your content!"
    }
  }'

// Velora Chat Bot Example

const VELORA_API = 'https://api.velora.tv/api/integrations/oauth';

class VeloraChatBot {
  constructor(accessToken) {
    this.accessToken = accessToken;
  }

  async sendMessage(channelId, message, options = {}) {
    const response = await fetch(
      `${VELORA_API}/chat/channels/${channelId}/messages`,
      {
        method: 'POST',
        headers: {
          'Authorization': `Bearer ${this.accessToken}`,
          'Content-Type': 'application/json',
        },
        body: JSON.stringify({
          message,
          // Set sendAsBot: true to post as your connected bot (needs
          // chat:write, this route's scope, plus a bot connected via
          // /integrations/oauth/bot/select or a bot-type app).
          // Omit/false to post as the authenticated user.
          sendAsBot: options.sendAsBot,
          effect: options.effect,
          effectColor: options.effectColor,
          replyTo: options.replyTo,
        }),
      }
    );

    if (!response.ok) {
      const error = await response.json();
      throw new Error(error.message || 'Failed to send message');
    }

    return response.json();
  }

  // Send a welcome message with glow effect
  async welcomeUser(channelId, username) {
    return this.sendMessage(
      channelId,
      `Welcome to the stream, @${username}! 🎉`,
      { effect: 'glow', effectColor: '#4ecdc4' }
    );
  }

  // Send a follow thank you with rainbow
  async thankFollower(channelId, username) {
    return this.sendMessage(
      channelId,
      `Thank you for the follow, @${username}! ❤️`,
      { effect: 'rainbow' }
    );
  }

  // Send a sub alert with gigantify
  async celebrateSub(channelId, username, months) {
    const emoji = months > 1 ? '🏆' : '🎊';
    return this.sendMessage(
      channelId,
      `${emoji} @${username} just subscribed for ${months} month(s)! ${emoji}`,
      { effect: 'gigantify' }
    );
  }

  // Reply to a message
  async replyTo(channelId, originalMessage, reply) {
    return this.sendMessage(channelId, reply, {
      replyTo: {
        messageId: originalMessage.id,
        username: originalMessage.username,
        snippet: originalMessage.content.substring(0, 100),
      },
    });
  }
}

// Usage Example
//
// BOTH values below are PLACEHOLDERS — replace them with real values.
//
// 1) The token is an OAuth ACCESS TOKEN obtained through the authorize flow
//    with the streamer's consent. There is no "bot token" to generate, and
//    client ID + secret alone will NOT work (no client-credentials grant).
//    Access tokens expire — refresh them, don't hard-code one.
//
// 2) channelId is the STREAMER'S USER ID (a UUID). On Velora a user's id IS
//    their channel id, so this is the account whose chat you're joining —
//    NOT their username, and not the literal string below.
//    Get it from GET /api/users/{username} — the id field on the response.
//    Usernames are case-sensitive. You can also read it from the
//    channelId field on any webhook event you receive for that channel.
const bot = new VeloraChatBot('your_oauth_access_token');
const channelId = 'streamer-user-id'; // a UUID, e.g. '3fa85f64-5717-4562-b3fc-2c963f66afa6'

// Welcome a new viewer
bot.welcomeUser(channelId, 'NewViewer123')
  .then(result => console.log('Message sent:', result.messageId))
  .catch(err => console.error('Error:', err.message));

// React to events from webhooks
async function handleWebhookEvent(event) {
  if (event.event === 'user.follow') {
    await bot.thankFollower(
      event.data.channel.id,
      event.data.follower.username
    );
  }

  if (event.event === 'channel.subscribe') {
    await bot.celebrateSub(
      event.data.channel.id,
      event.data.subscriber.username,
      event.data.months
    );
  }
}

GET /api/integrations/oauth/chat/settings
Authorization: Bearer YOUR_ACCESS_TOKEN

Response:
{
  "slowMode": false,
  "slowModeSeconds": 0,
  "followersOnly": false,
  "subscribersOnly": false,
  "emoteOnly": false
}

PATCH /api/integrations/oauth/chat/settings
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "slowMode": true,
  "slowModeSeconds": 5,
  "followersOnly": false,
  "subscribersOnly": false,
  "emoteOnly": false
}

POST /api/integrations/oauth/test/events
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "eventType": "subscription",
  "channelId": "YOUR_CHANNEL_ID",
  "tier": "tier1",
  "amount": 499,
  "message": "Test sub!"
}

POST /api/integrations/oauth/test/events/types
Authorization: Bearer YOUR_ACCESS_TOKEN