Developer Documentation

oEmbed Integration

What is oEmbed?

oEmbed is an open format for allowing embedded representation of URLs on web sites. It allows a website to display embedded content from another website.

WhatsApp Hub oEmbed Endpoint

Use Cases

• Social Media Embeds - Embed WhatsApp conversations and templates
• Blog Integration - Embed example conversations in blog posts
• Documentation - Show WhatsApp integration examples
• Support Pages - Display sample customer interactions
• Marketing Materials - Showcase WhatsApp features

Request Example

GET /oembed/
?url=https://maarketings.com/conversation/demo
&maxwidth=500
&maxheight=400

Response Format

{
  "type": "rich",
  "version": "1.0",
  "title": "WhatsApp Conversation",
  "html": "<iframe src='...'></iframe>",
  "width": 500,
  "height": 400
}

Testing

Use Meta's oEmbed Debugger to test our implementation:

WhatsApp Business API

Endpoints

Example: Send Message

curl -X POST https://maarketings.com/api/v1/messages/send \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "to": "+9999999999",
    "message": "Hello! Welcome to WhatsApp Hub",
    "type": "text"
  }'

Webhook Integration

Overview

WhatsApp Hub sends real-time notifications about message events to your webhook URL. This allows you to react immediately to incoming messages, delivery confirmations, and other events.

Event Types

• message.received - New incoming message
• message.delivered - Message delivered to contact
• message.read - Message read by contact
• message.failed - Message delivery failed
• contact.updated - Contact information updated
• template.approved - Template approved by Meta
• template.rejected - Template rejected by Meta

Webhook Payload Example

{
  "event": "message.received",
  "timestamp": 1644591234,
  "data": {
    "message_id": "wamid.123456789",
        "from": "+9999999999",
    "type": "text",
    "text": "Hello from WhatsApp",
    "timestamp": 1644591234
  }
}

Setting Up Webhooks

1. Get your unique webhook URL from your WhatsApp Hub account settings
2. Configure it in Meta WhatsApp Business Manager
3. WhatsApp Hub will receive notifications automatically
4. Process them in your application

Integration Examples

1. Embed a Conversation (oEmbed)

Display a WhatsApp conversation on your website:

2. Send a Template Message

Send a pre-approved WhatsApp template to a customer:

curl -X POST https://maarketings.com/api/v1/messages/send \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "to": "+9999999999",
    "template": "order_confirmation",
    "variables": {
      "order_id": "ORD-12345",
      "amount": "$99.99"
    }
  }'

3. Handle Incoming Messages

Process incoming messages from your webhook:

@app.route('/webhook', methods=['POST'])
def handle_webhook():
    data = request.json
    
    if data['event'] == 'message.received':
        message = data['data']
        phone_number = message['from']
        text = message['text']
        
        # Process the message
        # Send a response, etc.
        
    return {'status': 'ok'}

4. List All Templates

Retrieve all message templates:

curl -X GET https://maarketings.com/api/v1/templates/list \
  -H "Authorization: Bearer YOUR_TOKEN"