---
layout: page
title: ChatFacet
permalink: /reference/ChatFacet
---
**Kind**: global class  

* [ChatFacet](#ChatFacet)
    * [.delete(ts, channel, [opts], [optCb])](#ChatFacet+delete)
    * [.meMessage(channel, text, [optCb])](#ChatFacet+meMessage)
    * [.postEphemeral(channel, text, user, [opts], [optCb])](#ChatFacet+postEphemeral)
    * [.postMessage(channel, text, [opts], [optCb])](#ChatFacet+postMessage)
    * [.update(ts, channel, text, [opts], [optCb])](#ChatFacet+update)
    * [.unfurl(ts, channel, unfurls, [opts], [optCb])](#ChatFacet+unfurl)
    * [.getPermalink(channel, ts, [optCb])](#ChatFacet+getPermalink)

<a name="ChatFacet+delete"></a>

### chatFacet.delete(ts, channel, [opts], [optCb])
Deletes a message.

**Kind**: instance method of <code>[ChatFacet](#ChatFacet)</code>  
**See**: [chat.delete](https://api.slack.com/methods/chat.delete)  

| Param | Type | Description |
| --- | --- | --- |
| ts | <code>?</code> | Timestamp of the message to be deleted. |
| channel | <code>?</code> | Channel containing the message to be deleted. |
| [opts] | <code>Object</code> |  |
| opts.as_user | <code>?</code> | Pass true to delete the message as the authed user. [Bot   users](/bot-users) in this context are considered authed users. |
| [optCb] | <code>function</code> | Optional callback, if not using promises. |

<a name="ChatFacet+meMessage"></a>

### chatFacet.meMessage(channel, text, [optCb])
Share a me message into a channel.

**Kind**: instance method of <code>[ChatFacet](#ChatFacet)</code>  
**See**: [chat.meMessage](https://api.slack.com/methods/chat.meMessage)  

| Param | Type | Description |
| --- | --- | --- |
| channel | <code>?</code> | Channel to send message to. Can be a public channel, private group or IM   channel. Can be an encoded ID, or a name. |
| text | <code>?</code> | Text of the message to send. |
| [optCb] | <code>function</code> | Optional callback, if not using promises. |

<a name="ChatFacet+postEphemeral"></a>

### chatFacet.postEphemeral(channel, text, user, [opts], [optCb])
Sends an ephemeral message to a user in a channel.

**Kind**: instance method of <code>[ChatFacet](#ChatFacet)</code>  
**See**: [chat.postEphemeral](https://api.slack.com/methods/chat.postEphemeral)  

| Param | Type | Description |
| --- | --- | --- |
| channel | <code>?</code> | Channel, private group, or IM channel to send message to. Can be an   encoded ID, or a name. See [below](#channels) for more details. |
| text | <code>?</code> | Text of the message to send. See below for an explanation of   [formatting](#formatting). This field is usually required, unless you're providing only   `attachments` instead. |
| user | <code>?</code> | `id` of the user who will receive the ephemeral message.   The user should be in the channel specified by the `channel` argument. |
| [opts] | <code>Object</code> |  |
| opts.parse | <code>?</code> | Change how messages are treated. Defaults to `none`. See   [below](#formatting). |
| opts.link_names | <code>?</code> | Find and link channel names and usernames. |
| opts.attachments | <code>?</code> | Structured message attachments. |
| opts.as_user | <code>?</code> | Pass true to post the message as the authed user, instead of as a   bot. Defaults to false. See [authorship](#authorship) below. |
| [optCb] | <code>function</code> | Optional callback, if not using promises. |

<a name="ChatFacet+postMessage"></a>

### chatFacet.postMessage(channel, text, [opts], [optCb])
Sends a message to a channel.

**Kind**: instance method of <code>[ChatFacet](#ChatFacet)</code>  
**See**: [chat.postMessage](https://api.slack.com/methods/chat.postMessage)  

| Param | Type | Description |
| --- | --- | --- |
| channel | <code>?</code> | Channel, private group, or IM channel to send message to. Can be an   encoded ID, or a name. See [below](#channels) for more details. |
| text | <code>?</code> | Text of the message to send. See below for an explanation of   [formatting](#formatting). This field is usually required, unless you're providing only   `attachments` instead. |
| [opts] | <code>Object</code> |  |
| opts.parse | <code>?</code> | Change how messages are treated. Defaults to `none`. See   [below](#formatting). |
| opts.link_names | <code>?</code> | Find and link channel names and usernames. |
| opts.attachments | <code>?</code> | Structured message attachments. |
| opts.unfurl_links | <code>?</code> | Pass true to enable unfurling of primarily text-based content. |
| opts.unfurl_media | <code>?</code> | Pass false to disable unfurling of media content. |
| opts.username | <code>?</code> | Set your bot's user name. Must be used in conjunction with `as_user`   set to false, otherwise ignored. See [authorship](#authorship) below. |
| opts.as_user | <code>?</code> | Pass true to post the message as the authed user, instead of as a   bot. Defaults to false. See [authorship](#authorship) below. |
| opts.icon_url | <code>?</code> | URL to an image to use as the icon for this message. Must be used in   conjunction with `as_user` set to false, otherwise ignored. See [authorship](#authorship)   below. |
| opts.icon_emoji | <code>?</code> | emoji to use as the icon for this message. Overrides `icon_url`.   Must be used in conjunction with `as_user` set to false, otherwise ignored. See   [authorship](#authorship) below. |
| [optCb] | <code>function</code> | Optional callback, if not using promises. |

<a name="ChatFacet+update"></a>

### chatFacet.update(ts, channel, text, [opts], [optCb])
Updates a message.

**Kind**: instance method of <code>[ChatFacet](#ChatFacet)</code>  
**See**: [chat.update](https://api.slack.com/methods/chat.update)  

| Param | Type | Description |
| --- | --- | --- |
| ts | <code>?</code> | Timestamp of the message to be updated. |
| channel | <code>?</code> | Channel containing the message to be updated. |
| text | <code>?</code> | New text for the message, using the [default formatting   rules](/docs/formatting). |
| [opts] | <code>Object</code> |  |
| opts.attachments | <code>?</code> | Structured message attachments. |
| opts.parse | <code>?</code> | Change how messages are treated. Defaults to `client`, unlike   `chat.postMessage`. See [below](#formatting). |
| opts.link_names | <code>?</code> | Find and link channel names and usernames. Defaults to `none`.   This parameter should be used in conjunction with `parse`. To set `link_names` to `1`, specify   a `parse` mode of `full`. |
| opts.as_user | <code>?</code> | Pass true to update the message as the authed user. [Bot   users](/bot-users) in this context are considered authed users. |
| [optCb] | <code>function</code> | Optional callback, if not using promises. |

<a name="ChatFacet+unfurl"></a>

### chatFacet.unfurl(ts, channel, unfurls, [opts], [optCb])
Unfurl a URL within a message by defining its message attachment.

**Kind**: instance method of <code>[ChatFacet](#ChatFacet)</code>  
**See**: [chat.unfurl](https://api.slack.com/methods/chat.unfurl)  

| Param | Type | Description |
| --- | --- | --- |
| ts | <code>?</code> | Timestamp of the message to be updated. |
| channel | <code>?</code> | Channel of the message to be updated. |
| unfurls | <code>string</code> | a map of URLs to structured message attachments |
| [opts] | <code>Object</code> |  |
| opts.user_auth_required | <code>?</code> | Pass true to require user authorization. |
| [optCb] | <code>function</code> | Optional callback, if not using promises. |

<a name="ChatFacet+getPermalink"></a>

### chatFacet.getPermalink(channel, ts, [optCb])
Retrieve a permalink URL for a specific extant message.

**Kind**: instance method of <code>[ChatFacet](#ChatFacet)</code>  
**See**: [chat.getPermalink](https://api.slack.com/methods/chat.getPermalink)  

| Param | Type | Description |
| --- | --- | --- |
| channel | <code>?</code> | The ID of the conversation or channel containing the message. |
| ts | <code>?</code> | A message's ts value, uniquely identifying it within a channel. |
| [optCb] | <code>function</code> | Optional callback, if not using promises. |