HiBot Documentation

# Visit the registration page
https://dash.hibot.live/register

# Fill in your business details
# Verify your email address
# Complete your profile setup

// In your HiBot dashboard:
// 1. Go to Channels → WhatsApp
// 2. Click "Connect WhatsApp Business"
// 3. Follow the step-by-step guide
// 4. Verify your phone number
// 5. Start messaging!

const response = await fetch('https://api.hibot.live/v1/messages', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
  },
  body: JSON.stringify({
    to: 'RECIPIENT_PHONE_NUMBER',
    type: 'text',
    text: {
      body: 'Hello from HiBot!'
    }
  })
});

const data = await response.json();
console.log(data);

const response = await fetch('https://api.hibot.live/v1/account', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

// Verify webhook signature
const crypto = require('crypto');

function verifyWebhookSignature(payload, signature, secret) {
  const expectedSignature = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
    
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expectedSignature)
  );
}

const response = await fetch('https://api.hibot.live/v1/messages', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    to: '1234567890',
    type: 'text',
    text: {
      body: 'Hello! This is a test message from HiBot.'
    }
  })
});

const data = await response.json();
console.log(data);

const response = await fetch('https://api.hibot.live/v1/messages', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    to: '1234567890',
    type: 'template',
    template: {
      name: 'order_confirmation',
      language: {
        code: 'en'
      },
      components: [
        {
          type: 'body',
          parameters: [
            {
              type: 'text',
              text: 'ABC123'
            },
            {
              type: 'text',
              text: 'John Doe'
            }
          ]
        }
      ]
    }
  })
});

// Example webhook endpoint
app.post('/webhooks/hibot', (req, res) => {
  // Verify the webhook signature
  const signature = req.headers['x-hibot-signature'];
  const payload = JSON.stringify(req.body);
  
  if (!verifyWebhookSignature(payload, signature, WEBHOOK_SECRET)) {
    return res.status(401).send('Invalid signature');
  }
  
  // Process the webhook event
  const event = req.body;
  
  switch (event.type) {
    case 'message':
      handleMessage(event);
      break;
    case 'message_status':
      handleMessageStatus(event);
      break;
    case 'contact':
      handleContact(event);
      break;
  }
  
  res.status(200).send('OK');
});

// Message received event
{
  "type": "message",
  "timestamp": 1633046400,
  "message": {
    "id": "wamid.XXXXXXXXXXXXXXXXXXXXXXXX",
    "from": "1234567890",
    "type": "text",
    "text": {
      "body": "Hello, I need help with my order."
    }
  }
}

// Message status event
{
  "type": "message_status",
  "timestamp": 1633046500,
  "message_id": "wamid.XXXXXXXXXXXXXXXXXXXXXXXX",
  "status": "delivered",
  "recipient_id": "1234567890"
}