ak-add-integration

Add a Messaging Integration

Use this skill to add a messaging platform integration to your Agent Kernel project.

Instructions for the Agent

When the user wants to add a messaging integration, follow this workflow:

Step 1: Identify the Project

Check the user's current project for:

• An existing pyproject.toml with agentkernel dependency
• An agent definition file (e.g., app.py, server.py, demo.py)
• An existing config.yaml

If not found, suggest using the ak-init skill first.

Step 2: Ask Which Integration

Which messaging platform would you like to integrate?

1. Slack — Bot that responds in Slack channels and threads
2. WhatsApp — Bot via WhatsApp Business API (Meta)
3. Facebook Messenger — Bot via Messenger Platform (Meta)
4. Instagram — Bot via Instagram Messaging API (Meta)
5. Telegram — Bot via Telegram Bot API
6. Teams — Bot via Microsoft Teams (Azure Bot Framework)
7. Gmail — Email-based agent via Gmail API (polling)

Step 3: Generate Changes

For Slack

1. Update pyproject.toml dependencies:

Add slack to the extras:

dependencies = [
    "agentkernel[openai,api,slack]>=0.9.0",
]

2. Update config.yaml:

slack:
  agent_acknowledgement: "I'm processing your request"
  # agent: general  # Optional: specify which agent handles Slack messages

3. Update the server file:

from agentkernel.api import RESTAPI
from agentkernel.slack import AgentSlackRequestHandler
# ... existing agent imports and definitions ...

if __name__ == "__main__":
    RESTAPI.run([AgentSlackRequestHandler()])

4. Environment variables needed:

export SLACK_BOT_TOKEN="xoxb-..."          # Bot User OAuth Token
export SLACK_SIGNING_SECRET="..."          # App signing secret

5. Setup instructions:

• Create a Slack App at https://api.slack.com/apps
• Enable Event Subscriptions → set Request URL to https://<your-domain>/slack/events
• Subscribe to bot events: message.channels, message.groups, message.im, message.mpim
• Install the app to your workspace
• Copy Bot Token and Signing Secret to environment variables