Quick Start Guide#

curl https://api.outeract.com/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "mutation SendMessage($userId: UUID!, $message: String!) { sendMessage(recipientUserId: $userId, message: $message) { id eventTypeName payload createdAt } }",
    "variables": {
      "userId": "RECIPIENT_USER_ID",
      "message": "Hello from Outeract!"
    }
  }'

import requests

response = requests.post(
    "https://api.outeract.com/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "query": """
            mutation SendMessage($userId: UUID!, $message: String!) {
              sendMessage(recipientUserId: $userId, message: $message) {
                id
                eventTypeName
                payload
                createdAt
              }
            }
        """,
        "variables": {
            "userId": "RECIPIENT_USER_ID",
            "message": "Hello from Outeract!",
        },
    },
)

print(response.json())

const response = await fetch('https://api.outeract.com/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: `
      mutation SendMessage($userId: UUID!, $message: String!) {
        sendMessage(recipientUserId: $userId, message: $message) {
          id
          eventTypeName
          payload
          createdAt
        }
      }
    `,
    variables: {
      userId: 'RECIPIENT_USER_ID',
      message: 'Hello from Outeract!'
    }
  })
});

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

from flask import Flask, request, jsonify
import requests
import hmac
import hashlib

app = Flask(__name__)

OUTERACT_API_KEY = "your-api-key"
WEBHOOK_SECRET = "your-webhook-secret"

SEND_MESSAGE = """
mutation SendMessage($userId: UUID!, $message: String!) {
  sendMessage(recipientUserId: $userId, message: $message) {
    id
  }
}
"""

@app.route("/webhooks/outeract", methods=["POST"])
def handle_webhook():
    # Verify signature
    signature = request.headers.get("X-Outeract-Signature")
    expected = hmac.new(
        WEBHOOK_SECRET.encode(),
        request.data,
        hashlib.sha256
    ).hexdigest()

    if not hmac.compare_digest(f"sha256={expected}", signature):
        return jsonify({"error": "Invalid signature"}), 401

    data = request.json

    if data["event_type"] == "message.inbound":
        # Echo the message back to the sender
        sender_user_id = data["data"]["user_id"]
        message_text = data["data"]["message"]["text"]

        requests.post(
            "https://api.outeract.com/",
            headers={"Authorization": f"Bearer {OUTERACT_API_KEY}"},
            json={
                "query": SEND_MESSAGE,
                "variables": {
                    "userId": sender_user_id,
                    "message": f"You said: {message_text}",
                },
            },
        )

    return jsonify({"status": "ok"})

if __name__ == "__main__":
    app.run(port=3000)

const express = require('express');
const crypto = require('crypto');

const app = express();
app.use(express.json());

const OUTERACT_API_KEY = 'your-api-key';
const WEBHOOK_SECRET = 'your-webhook-secret';

const SEND_MESSAGE = `
  mutation SendMessage($userId: UUID!, $message: String!) {
    sendMessage(recipientUserId: $userId, message: $message) {
      id
    }
  }
`;

app.post('/webhooks/outeract', async (req, res) => {
  // Verify signature
  const signature = req.headers['x-outeract-signature'];
  const expected = 'sha256=' + crypto
    .createHmac('sha256', WEBHOOK_SECRET)
    .update(JSON.stringify(req.body))
    .digest('hex');

  if (signature !== expected) {
    return res.status(401).json({ error: 'Invalid signature' });
  }

  const { event_type, data } = req.body;

  if (event_type === 'message.inbound') {
    // Echo the message back to the sender
    await fetch('https://api.outeract.com/', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${OUTERACT_API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        query: SEND_MESSAGE,
        variables: {
          userId: data.user_id,
          message: `You said: ${data.message.text}`
        }
      })
    });
  }

  res.json({ status: 'ok' });
});

app.listen(3000, () => console.log('Server running on port 3000'));