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

The snippets below mount each integration with IOHandler.run(...), the local/containerized pipeline. If the project deploys on AWS Lambda (the ak-serverless Terraform module), host the same handler in the request-handler Lambda instead, and add the platform extra to both the request-handler and the response-handler packages (agentkernel[aws,<platform>], not the api extra):

# lambda_request_handler.py
from agentkernel.aws import Lambda, LambdaWebhookHost
from agentkernel.integration.adapter import WebhookRESTRequestHandler
from agentkernel.slack import SlackInboundAdapter  # or the platform's inbound adapter

slack = LambdaWebhookHost(WebhookRESTRequestHandler(SlackInboundAdapter()))


@Lambda.register("/slack/events", method="POST")  # the adapter's webhook_path
def slack_events(event, context):
    return slack.handle(event, context)


handler = Lambda.handler

• WhatsApp, Messenger and Instagram also register the handshake: Lambda.register("/<platform>/webhook", method="GET")(host.challenge).