Check Messages

Check Messages — Review What Your Aicoo Received

See all messages people sent to your agent, organized by conversation with contact info and timestamps.

Prerequisites

• AICOO_API_KEY environment variable must be set
• Base URL: https://www.aicoo.io/api/v1

Workflow

Step 1: Get your identity (for filtering)

IDENTITY=$(curl -s "https://www.aicoo.io/api/v1/identity" \
  -H "Authorization: Bearer $AICOO_API_KEY")
CALLER_ID=$(echo "$IDENTITY" | jq -r '.profile.userId')
USERNAME=$(echo "$IDENTITY" | jq -r '.profile.username')

Step 2: Fetch conversations

# All conversations (both direct human messages and shared-agent chats)
curl -s "https://www.aicoo.io/api/v1/conversations?view=all&limit=50" \
  -H "Authorization: Bearer $AICOO_API_KEY" | jq .

Views:

• view=me — direct messages to you (human-to-human)
• view=coo — messages people sent to your shared agent
• view=all — everything combined

Step 3: Fetch pending network requests

curl -s "https://www.aicoo.io/api/v1/network/requests" \
  -H "Authorization: Bearer $AICOO_API_KEY" | jq .

Step 4: Parse and present

For each conversation, extract:

• Contact: who sent the message (name, username, or "anonymous visitor")
• Channel: direct (me) or via shared agent (coo)
• Messages: timestamp + content, newest first
• Unread: messages where senderId != CALLER_ID

Group by conversation and present as:

Messages for @username

── Via Shared Agent (COO) ──────────────────────

1. @alice (Alice Chen) — 3 messages, latest: 2h ago
   "What's the timeline for Project Alpha?"
   "Can you share the API documentation?"
   "Thanks, one more question about pricing..."

2. Anonymous (share link: For Investors) — 1 message, latest: 5h ago
   "What's your current ARR and growth rate?"

── Direct Messages ─────────────────────────────

3. @bob (Bob Martinez) — 2 messages, latest: 1d ago
   "Hey, can we sync on the sprint tomorrow?"
   "Also, did you see the security review?"

── Pending Requests ────────────────────────────

4. @carol wants to connect (friend request) — 2d ago

Summary: 6 new messages across 3 conversations, 1 pending request

Step 5: Offer actions

For each item, suggest available actions:

| Situation | Suggested Action | |-----------|-----------------| | Unread COO message | "Want me to draft a reply?" | | Pending friend request | "Accept or decline @carol's request?" | | Pending agent request | "Grant agent access to @carol?" | | Interesting question from visitor | "Want to save this as a contact note?" |

Filtering Options

The user can narrow results:

• By channel: "just COO messages" → view=coo
• By time: "messages from today" → filter by timestamp
• By contact: "messages from alice" → filter by contact name/username
• Unread only: filter where senderId != CALLER_ID

Error Handling

| Error | Action | |-------|--------| | 401 from /identity | API key invalid — guide to settings page | | Empty conversations list | "No messages yet. Share an agent link to start receiving messages." | | Empty requests list | "No pending network requests." |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Aicoo-Team
• Source: Aicoo-Team/AICOO-Skills
• License: MIT
• Homepage: https://aicoo.io/docs

Install and usage instructions live in the source repository linked above.