Skip to main content
After this guide, your agent answers you on WhatsApp, Messenger, Instagram, or Slack through accounts that Lua operates, with no channel of your own connected. Use it to see how a reply renders on a real messaging app. To test your own number, Page, or workspace, connect that channel instead. Verified against lua-cli 3.33.0. Before you begin
  • An agent with a promoted production version. The test channels deliver to production; see Release an agent.
  • Your agent ID. It is agent.agentId in lua.skill.yaml, and project.agentId in lua status --json --ci.
lua.skill.yaml
1

Copy the link command

The command is your agent ID after link-me-to: with no space. Lua matches it anywhere in the message, so send it on its own to avoid surprises.
2

Send it on the channel

Each channel is a Lua-operated account; the command tells it which agent your messages should reach.
Open https://wa.me/13023778932?text=link-me-to:<agentId> with your agent ID in place of <agentId>, or message +1 302 377 8932 and type the command. Send the prefilled message.
3

Read the confirmation

The channel replies You are now connected to <agentId>, to remove the connection, send "remove-my-link". After that, your messages on that channel go to your agent.
4

Verify

Send hello. The reply comes from your agent’s production version. To confirm the turn reached it, read the agent’s recent logs.
5

Unlink when you are done

Send remove-my-link on the same channel. The reply is You are now disconnected from <agentId>.
  • The link is per sender and per channel. Only your messages, on that channel, route to your agent; other people keep talking to whatever the channel normally serves. A new link-me-to: replaces your previous link on that channel, and a link on WhatsApp says nothing about Messenger or Slack.
  • The same command works on channels you connect yourself. Send link-me-to:<agentId> to any WhatsApp, Messenger, Instagram, Slack, Teams, or SMS channel linked to one of your agents and your messages there go to the named agent instead. Email channels don’t support it.
  • The agent ID isn’t checked. A typo links you to an agent that doesn’t exist and the channel goes silent; send remove-my-link and try again.
  • Nothing is added to your agent. lua channels list stays empty, so Channels.send has no channel of yours to send from, and WhatsApp message templates, which belong to your own WhatsApp Business Account, can’t be exercised. Slack response settings and Teams tenant binding are also your own channel’s, not the test account’s.

​
Troubleshooting

The prefix is link-me-to: with a colon and no space before the ID. On Slack, the command must be a direct message to the Lua app, not a message in a channel.
Either the agent has no promoted production version, or the ID has a typo and the link points nowhere. Compare the ID with project.agentId in lua status --json --ci, check lua version list, then send remove-my-link and link again.
An earlier link on this channel is still active. Send remove-my-link, wait for the disconnection reply, then send the new command.

​
Next steps

Channels overview

Connect your own channel when the agent is ready for end users.

Response formatting

Check which components the channel you tested on renders.

Test an agent before you release

Run tools locally with lua test and chat in the sandbox with lua chat.