menus<\/a>.<\/span><\/li>\n<\/ul>\nPOST \/api\/chat.postMessage<\/span><\/p>\nContent-type: application\/json<\/span><\/p>\nAuthorization: Bearer xoxp-xxxxxxxxx-xxxx<\/span><\/p>\n{“channel”:”C061EG9SL”,”text”:”I hope the tour went well, Mr. Wonka.”,”attachments”:[{“text”:”Who wins the lifetime supply of chocolate?”,”fallback”:”You could be telling the computer exactly what it can do with a lifetime supply of chocolate.”,”color”:”#3AA3E3″,”attachment_type”:”default”,”callback_id”:”select_simple_1234″,”actions”:[{“name”:”winners_list”,”text”:”Who should win?”,”type”:”select”,”data_source”:”users”}]}]}<\/span><\/p>\n\n- Next you need to authenticate the requests of Slack API. The step is achieved by providing the bearer token. To negotiate tokens or on <\/span>how to get Slack API token<\/span>, you need to register your application with Slack and obtain the required credentials. The token can be sent as an HTTP header or in the POST parameter.<\/span><\/li>\n
- For returning results in Slack rest API, use the cursor-based approach. This will help to return a certain portion of the total results set or point to the next portion of the result set. A sample code for a request to the next page and limited to 2 results<\/span><\/li>\n<\/ul>\n
GET slack.com\/api\/users.list?limit=2&cursor=dXNlcjpVMEc5V0ZYTlo%3D&token=xoxp-1234-5678-90123<\/span><\/p>\n\n- Limit your apps with 1 request per second for any API call in Slack API integration<\/span><\/li>\n
- Use the event API to deliver events that count up to 30,000 deliveries per workspace per hour<\/span><\/li>\n
- You can initiate your application via the Slack integration API in two ways – via a Slash command like using \/mycallapp inside the composer. The other way is to use the Call icon.\u00a0<\/span><\/li>\n
- To set up the app you need to call the Slash command. The command buttons can be found under Add features and functionality. You will find the option to Create a new command.<\/span><\/li>\n
- Slack then sends a payload to your app which looks as below,<\/span><\/li>\n<\/ul>\n
{<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“token”: “<verification token>”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“team_id”: “T123ABC456”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“team_domain”: “my-team”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“channel_id”: “C123ABC456”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“channel_name”: “test”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“user_id” : “U123ABC456”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“user_name”: “mattjones”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“response_url”:”https:\/\/slack.com\/callback\/123xyz”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“type”: “video”<\/span><\/p>\n}<\/span><\/p>\n\n- You then need to post your response to the response_url of the Slack connect API. You need to enter the following<\/span><\/li>\n<\/ul>\n
\u00a0{<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“response_type”:”call”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“call_initiation_url”:”https:\/\/join.call.com\/123456″,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“desktop_protocol_call_initiation_url”: “call:\/\/join&room_id=123456”<\/span><\/p>\n}<\/span><\/p>\n\n- If you want to launch your app in desktop then use this <\/span>desktop_protocol_call_initiation_url\u00a0<\/span><\/li>\n
- If you want the call type to be video then you need to ensure the initiation URL begins with a video. If its audo, then you need to enter the phone number received in the payload. Code sample\u00a0<\/span><\/li>\n<\/ul>\n
{<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“response_type”: “audio”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“call_initiation_url”: “https:\/\/your_company_url\/…”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“desktop_protocol_call_initiation_url”: “your_call_app_url:\/\/+1-202-555-0145”<\/span><\/p>\n}<\/span><\/p>\n\n- The calls.add method will now need to be used for adding the details of the call to the Slack webhook API. Store the id received as a response to refer while ending or updating the call<\/span><\/li>\n
- Post the call to the channel. Sample code\u00a0<\/span><\/li>\n<\/ul>\n
“blocks”: [<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0{<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0“type”: “call”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0“call_id”: “R123”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0}<\/span><\/p>\n\n- Next you need to unfurl a call in the channel. The sample code is\u00a0<\/span><\/li>\n<\/ol>\n
{<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“token”: “xxxx-xxxxxxxxx-xxxx”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“channel”: “C123ABC456”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“ts”: “12345.6789”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“unfurls”: {<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0“https:\\\/\\\/url.to\\\/your\\\/call”: {<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0“blocks”: [{<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0“type”: “call”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0“call_id”: “Rxxx”<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0}]<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0}<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0}<\/span><\/p>\n}<\/span><\/p>\n\n- While responding to a rejected call, the following sample payload needs to be utilized\u00a0<\/span><\/li>\n<\/ul>\n
{<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“token”: “12345FVmRUzNDOAuy4BiWh”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“team_id”: “T123ABC456”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“api_app_id”: “B123ABC456”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“event”: {<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0“type”: “call_rejected”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0“call_id”: “RL731AVEF”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0“user_id”: “U123ABC456”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0“channel_id”: “D123ABC456”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0“external_unique_id”: “123-456-7890”<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0},<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“type”: “event_callback”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“event_id”: “Ev123ABC456”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“event_time”: 1563448153,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“authed_users”: [“U123ABC456”]<\/span><\/p>\n}<\/span><\/p>\n\n- To update a call use calls.update_method and to and add or modify participants or users, use calls.participants.remove<\/span><\/li>\n
- To end a call, use the calls.end method<\/span><\/li>\n
- As a Slack API user, you can set up custom Slack API status, represented by the attributes status_text, status_emoji, and status_expiration profile attributes. You can retrieve the status of a user by using users.profile.get command<\/span><\/li>\n
- You can set the custom status of a user through Slack API key or access token and entering into the users.profile.set method. The parameter for the profile must be a URL-encoded JSON string. The string must have the attribute as status_text<\/span><\/li>\n<\/ul>\n
Sample code:<\/span><\/p>\n{<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“status_text”: “riding a train”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“status_emoji”: “:mountain_railway:”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“status_expiration”: 0<\/span><\/p>\n}<\/span><\/p>\n\n- To unset the status, <\/span>status_text, and status_emoji are set to empty<\/span><\/li>\n
- You can expire the status of the user, using status_expiration command.<\/span><\/li>\n<\/ol>\n
Sample code<\/span><\/p>\n{<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“status_text”: “riding the train home”,<\/span><\/p>\n\u00a0\u00a0\u00a0\u00a0“status_emoji”: “:mountain_railway:”,<\/span><\/p>\n