Customer mention & comment alerts in Slack

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_code": "comment_mention", "hook_url": "https://your-receiver.example.com/onramp-events"}' \
  "https://api.onramp.us/v1/webhooks"

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_code": "comment_new", "hook_url": "https://your-receiver.example.com/onramp-events"}' \
  "https://api.onramp.us/v1/webhooks"

import requests

BASE = "https://api.onramp.us/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

for event_code in ("comment_mention", "comment_new"):
    requests.post(f"{BASE}/webhooks", headers=HEADERS, json={
        "event_code": event_code,
        "hook_url": "https://your-receiver.example.com/onramp-events",
    })

for (const event_code of ["comment_mention", "comment_new"]) {
  await fetch("https://api.onramp.us/v1/webhooks", {
    method: "POST",
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      event_code,
      hook_url: "https://your-receiver.example.com/onramp-events",
    }),
  });
}

from flask import Flask, request

import requests

BASE = "https://api.onramp.us/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}
SLACK_URL = "https://hooks.slack.com/services/YOUR/SLACK/WEBHOOK"
MY_API_USER_UUID = "…from step 2…"

app = Flask(__name__)
seen = set()  # deliveries can repeat — dedupe (swap for Redis/db in production)

def get(path):
    return requests.get(f"{BASE}{path}", headers=HEADERS).json()["data"]

@app.post("/onramp-events")
def on_event():
    event = request.get_json(silent=True) or {}
    comment_uuid = (event.get("payload") or {}).get("comment", {}).get("uuid")
    if not comment_uuid:
        return "", 204                       # not a comment event — ignore
    key = (event.get("event_name"), comment_uuid, event.get("timestamp"))
    if key in seen:
        return "", 204                       # duplicate delivery — ignore
    seen.add(key)

    # Fetch-on-event: trust only the uuid, pull the real data yourself
    comment = get(f"/comments/{comment_uuid}")
    if comment["created_by_uuid"] == MY_API_USER_UUID:
        return "", 204                       # our own API post — never echo

    task = get(f"/tasks/{comment['associated_object_uuid']}")
    kind = "🔔 Mention" if event.get("event_name") == "comment_mention" else "💬 New comment"
    requests.post(SLACK_URL, json={"text": (
        f"{kind} from *{comment['created_by_name']}* on "
        f"*{task['name']}* ({task['project']['name']})\n"
        f"> {comment['message_plain']}\n"
        f"<{task['internal_project_url']}|Open in OnRamp>"
    )})
    return "", 200

app.run(port=8080)

import express from "express";

const BASE = "https://api.onramp.us/v1";
const HEADERS = { Authorization: "Bearer YOUR_API_KEY" };
const SLACK_URL = "https://hooks.slack.com/services/YOUR/SLACK/WEBHOOK";
const MY_API_USER_UUID = "…from step 2…";

const get = async (path) =>
  (await (await fetch(BASE + path, { headers: HEADERS })).json()).data;

const seen = new Set(); // dedupe repeats (swap for Redis/db in production)
const app = express().use(express.json());

app.post("/onramp-events", async (req, res) => {
  const event = req.body ?? {};
  const commentUuid = event.payload?.comment?.uuid;
  if (!commentUuid) return res.sendStatus(204);
  const key = `${event.event_name}:${commentUuid}:${event.timestamp}`;
  if (seen.has(key)) return res.sendStatus(204);
  seen.add(key);

  const comment = await get(`/comments/${commentUuid}`);
  if (comment.created_by_uuid === MY_API_USER_UUID) return res.sendStatus(204);

  const task = await get(`/tasks/${comment.associated_object_uuid}`);
  const kind = event.event_name === "comment_mention" ? "🔔 Mention" : "💬 New comment";
  await fetch(SLACK_URL, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      text: `${kind} from *${comment.created_by_name}* on *${task.name}* (${task.project.name})\n> ${comment.message_plain}\n<${task.internal_project_url}|Open in OnRamp>`,
    }),
  });
  res.sendStatus(200);
});

app.listen(8080);

# The receiver is a small web service (see Python/Node tabs). These are the
# two enrichment calls it makes for each event:

# The real comment (author, text, which task it's on)
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.onramp.us/v1/comments/COMMENT_UUID"

# The task, its project, and dashboard links
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.onramp.us/v1/tasks/TASK_UUID"