channel.play doesn't work

[otatar]

Hi there,

today I have tried you lib, but it seems that channel.play doesn't work. I have managed to sniff HTTP request to asterisk http api and it looks like this:
3459 266.198305756 127.0.0.1 → 127.0.0.1 HTTP/JSON 458 POST /ari/channels/1744378993.3/play/5e3fabc0-5168-46e5-b83d-e0a4a6e0c793 HTTP/1.1 , JavaScript Object Notation (application/json)
According to this: [link]https://docs.asterisk.org/Latest_API/API_Documentation/Asterisk_REST_Interface/Channels_REST_API/#playl) the api call shoul look like this:
HTTP/JSON 458 POST /ari/channels/1744378993.3/play?media=sound:demo-congrats`

I have even tried this from curl, and it is working. So I can conclude that you are missing query parameters in your api call....

[fabiotheo]

Hi! Thanks a lot for the feedback and for trying out the library!

The issue you described seems to be related to the use of the /play/{playbackId} endpoint instead of /play?media=.... Let me clarify:

Our implementation uses the following request format:

POST /ari/channels/{channelId}/play/{playbackId}

With the request body:

{
  "media": "sound:demo-congrats",
  "lang": "en"
}

This is exactly the expected behavior according to the official Asterisk ARI documentation.

📌 Summary of the spec:

• If you're using /channels/{channelId}/play → the media should be sent as a query parameter (?media=sound:...)
• If you're using /channels/{channelId}/play/{playbackId} → the media must be sent in the request body

In our case, we're correctly using the second format (/play/{playbackId}), which allows more control (e.g. stopping the playback programmatically). Here's a working example:

await instanceChannel.play({ media: 'sound:enable_foward' });

And it works consistently on our side with Asterisk 20+.

---

Conclusion:
There’s no need to change the implementation — it’s fully compliant and functioning as expected. If something isn’t working on your setup, it might be related to environment or version-specific behavior.

If you'd like, I can provide a full example to help you compare with your current setup. Also, feel free to share a minimal reproducible snippet so we can better assist you.

Thanks again for the report and let us know how we can support you!

[otatar]

This is the snippet from official documentation and I cannot see the thing with request body, all is in query parameters