topic Re: How to create a webhook for a webex space? in Webex for Developers

How to create a webhook for a webex space?

alec990 — Tue, 22 Mar 2022 15:23:41 GMT

I am using a webex application and can create spaces.

How can I create a webhook to post messages to my spaces from an external application?

Any pointer would be appreciated.

Thanks

Re: How to create a webhook for a webex space?

dtibbe — Tue, 22 Mar 2022 15:26:20 GMT

A webhook is used to notify your application of an event.

If you want to post something to a space, simply create a bot and use the bot's access token along with https://developer.webex.com/docs/api/v1/messages/create-a-message

Re: How to create a webhook for a webex space?

alec990 — Tue, 22 Mar 2022 15:45:04 GMT

Thanks, I have created a bot, got my access token, now I need more help for finding the right POST arguments...

From the space I want to post to, I found the space link which looks like:

webexteams://im?space=<uuid>

How can I find out the URL to use to post the message? how about roomId, is it the space uuid?

Thanks!

Re: How to create a webhook for a webex space?

dtibbe — Tue, 22 Mar 2022 15:55:43 GMT

The page I linked gives you the URL for the POST: https://webexapis.com/v1/messages

The parameters are described at the page. You do not need all off them, mostly I use markdown and either toPersonEmail or roomId, depending on the use case.

The roomId can be fetched by listing all rooms you're in: https://developer.webex.com/docs/api/v1/rooms/list-rooms. Do not use the UUID-form you get from CRTL-SHIFT-K and that can be used for the protocol handlers you mentioned. You have to use the base64 encoded ones as returned by the list-rooms endpoint.

If you want to sent the bot the message to a person directly, you may also specify the mail address instead in the toPersonEmail parameter.

Re: How to create a webhook for a webex space?

alec990 — Tue, 22 Mar 2022 16:57:50 GMT

Ahhh, thanks for the clarification, it makes sense now,

I did not know that the panel on the right side was live on actual webex spaces! Clever!

I managed to send a message to my space, thank you!

Re: How to create a webhook for a webex space?

alec990 — Tue, 22 Mar 2022 19:38:39 GMT

One extra step that is needed and was not documented, is that the bot email address must be explicitly added to the space.

I failed to do that and got this error message:

Error postMessage failed: request failed with status code 404, {"message":"Could not find a room with provided ID.","errors"...

I thought my roomID was wrong!