Agent messaging endpoint

The agent messaging endpoint is the endpoint where you send agentic notification messages to your agent.

Delete agent messaging endpoint

Use the a365 cleanup blueprint --endpoint-only command to clear the agent messaging endpoint registration. This command doesn't affect your agent code or the deployed endpoint. It only removes the registration entry.

For M365 agents (Teams, Copilot), pass --m365 to clear the endpoint via Teams Graph:

# M365 agents — clears via Teams Graph (MCP Platform)
a365 cleanup blueprint --endpoint-only --m365

# Non-M365 agents — prints the Teams Developer Portal URL for manual configuration
a365 cleanup blueprint --endpoint-only

Configure messaging endpoint in a365.config.json

Before setting the messaging endpoint, specify it in your a365.config.json configuration file. This file contains the core configuration for your agent deployment.

Add or update these messaging endpoint configuration properties:

{
  "messagingEndpoint": "https://your-endpoint-url.com/api/messages",
  "deploymentProjectPath": "."
}

  • messagingEndpoint: Specify the exact endpoint URL where you can send messages to the agent.

  • deploymentProjectPath: Path to your agent project directory. This property isn't relevant if your agent is already deployed and you don't need to update environment configuration. Set deploymentProjectPath to . only if the agent code isn't located on your machine.

Configuration properties

Property Description Required Default Example
messagingEndpoint The URL where your agent receives messages Yes None https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Path to your agent project directory for configuration updates No . ./my-agent or .

Endpoint configuration options

The messagingEndpoint value depends on your deployment scenario:

For Azure deployments:

  • Azure Web App: https://your-app-name.azurewebsites.net/api/messages

For non-Azure deployments:

  • AWS: https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP: https://your-cloud-run-url.run.app/api/messages
  • Other cloud providers: Your custom endpoint URL

For local testing with Dev Tunnels:

  • Dev Tunnel URL: https://abc123xyz.devtunnels.ms:3978/api/messages

Important

The deploymentProjectPath specifies where the CLI looks for project files and where it updates environment configuration, such as .env files.

Note

When using Dev Tunnels for local testing, update the messagingEndpoint in a365.config.json with your Dev Tunnel URL before running the setup command. For more information, see testing with Dev Tunnels.

Set agent messaging endpoint

After updating your a365.config.json file, use this command to register the messaging endpoint so that the Agent 365 service can send notifications to your agent.

For M365 agents (Teams, Copilot), pass --m365 to register via Teams Graph:

# M365 agents — registers via Teams Graph (MCP Platform)
a365 setup blueprint --endpoint-only --m365

# Non-M365 agents — prints the Teams Developer Portal URL for manual configuration
a365 setup blueprint --endpoint-only

During local testing, you can set this endpoint to a Dev Tunnel endpoint before deploying the agent to the cloud. For more information, see testing with Dev Tunnels.

To update an existing endpoint URL:

a365 setup blueprint --update-endpoint https://your-new-host.example.com/api/messages --m365

Deployment of endpoint

If you don't already have your agent deployed to the cloud, learn how to deploy agent to Azure.

If you already have your agent deployed to the cloud, you can set the messaging endpoint as shown earlier.

Learn how to set the messaging endpoint on some other popular clouds:

  • Last updated on