> ## Documentation Index
> Fetch the complete documentation index at: https://www.cometchat.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Message Shortcuts

> Message Shortcuts — CometChat documentation.

The Message Shortcuts extension enables your users to send each other predefined messages.

For example, **!hb** can be automatically expanded to **Happy birthday!**

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b/Relz_yItqW5RHUsU/images/4e69724a-zlb2ftf9q4n8eirwil7dot7dpm8wsquieyxivb81wuoxr427oiqy63k0xfq7055e-0e44d76d994c922dce3329df2a1327be.jpeg?fit=max&auto=format&n=Relz_yItqW5RHUsU&q=85&s=e63bd15ec8adc22a9b5cf4120bfb9cd8" width="1200" height="675" data-path="images/4e69724a-zlb2ftf9q4n8eirwil7dot7dpm8wsquieyxivb81wuoxr427oiqy63k0xfq7055e-0e44d76d994c922dce3329df2a1327be.jpeg" />
</Frame>

## Extension settings

1. Login to [CometChat](https://app.cometchat.com/login) and select your app.
2. Go to the Extensions section and enable the Message shortcuts extension.
3. Open the settings for this extension.
4. You should a list of Global Message shortcuts.
5. Edit the existing shortcuts or add new ones.
6. Save your settings.

## How does it work?

The shortcuts saved in the Extension's settings are Global message shortcuts that can be accessed by all the users of your app. The shortcuts saved by users are accessible only to them along with the Global message shortcuts.

With the Message Shortcuts extension, you can:

1. Fetch all shortcuts on your user's device.
2. Allow users to edit, define or delete shortcuts.
3. Send predefined message by typing shortcuts.

## Implementation

### 1. Fetch all shortcuts

Once the user has successfully logged in, you can request the shortcuts from the extension. Additionally, you can provide a button to refresh the shortcuts.

Make use of the `callExtension` method exposed by the CometChat SDK to fetch the shortcuts.

<Tabs>
  <Tab title="JavaScript">
    ```js theme={null}
    CometChat.callExtension('message-shortcuts', 'GET', 'v1/fetch', null)
    .then(shortcuts => {
     	 // Save these shortcuts locally.
    })
    .catch(error => {
    	// Some error occured
    });
    ```
  </Tab>

  <Tab title="Java">
    ```java theme={null}
    CometChat.callExtension("message-shortcuts", "GET", "/v1/fetch", null,
        new CometChat.CallbackListener<JSONObject>() {
        @Override
        public void onSuccess(JSONObject responseObject) {
            // Shortcuts received here.
        }

        @Override
        public void onError(CometChatException e) {
            // Some error occured.
        }
    });
    ```
  </Tab>

  <Tab title="Swift">
    ```swift theme={null}
    CometChat.callExtension(slug: "message-shortcuts", type: .get, endPoint: "v1/fetch", body: nil, onSuccess: { (response) in
    	print("Stickers",response)
    }) { (error) in
      print("Error",error?.errorCode, error?.errorDescription)
    }
    ```
  </Tab>
</Tabs>

The response will have the following JSON structure:

<Tabs>
  <Tab title="JSON">
    ```json theme={null}
    {
      "shortcuts": {
        "!hbd": "Happy Birthday! 🥳",
        "!cu": "See you later.",
        "!ty": "Hey! Thanks a lot! 😊",
        "!wc": "You're welcome!"
      }
    }
    ```
  </Tab>
</Tabs>

### 2. Modify shortcuts

Shortcuts can be added, edited or deleted by your users. You need to have a section in your front-end application that allows the users to do so. The extension accepts a final list of shortcuts after all the modifications have been done by the user.

Make use of the `callExtension` method exposed by the CometChat SDK to submit the final customized list.

<Tabs>
  <Tab title="JavaScript">
    ```js theme={null}
    const finalList = {
      shortcuts: {
        "!hbd":"Happy birthday! Have fun!"
      }
    };

    CometChat.callExtension('message-shortcuts', 'POST', 'v1/update', finalList)
    .then(response => {
     	 // Updated successfully.
    })
    .catch(error => {
    	// Some error occured
    });
    ```
  </Tab>

  <Tab title="Java">
    ```java theme={null}
    import org.json.simple.JSONObject;

    JSONObject finalList = new JSONObject();
    JSONObject shortcuts = new JSONObject();

    shortcuts.put("!hbd", "Happy birthday! Have fun!");
    shortcuts.put("!ttyl", "Talk to you later");

    finalList.put("shortcuts", shortcuts);

    CometChat.callExtension("message-shortcuts", "POST", "/v1/update", finalList,
     new CometChat.CallbackListener < JSONObject > () {
        @Override
        public void onSuccess(JSONObject jsonObject) {
            //On Success
        }
        @Override
        public void onError(CometChatException e) {
            //On Failure
        }
    });
    ```
  </Tab>

  <Tab title="Swift">
    ```swift theme={null}
    let finalList = ["shortcuts": ["!hbd": "Happy Birthday!" ,
                "!cu" : "See you later.",
                "!ty", "Hey! Thanks a lot! :blush:",
                "!wc", "You're welcome!"]]
    CometChat.callExtension(slug: "message-shortcuts", type: .post, endPoint: "v1/update", body: finalList, onSuccess: { (response) in
    	// Updated successfully.
    }) { (error) in
    	// Error occured
    }
    ```
  </Tab>
</Tabs>

### 3. Use shortcuts

The UI implementation can be as follows:

1. When `!` is typed in the message composer, a list pops up above the message composer with all the available shortcuts and their predefined values.
2. On typing the next letter after the`!` typed earlier, the list gets filtered with the shortcuts that start with that letter.
3. Clicking on any shortcut from the list, expands the corresponding predefined message in the message composer.