---
title: webexteams.message() function
description: webexteams.message() sends a single message to Webex using the Webex messages API.
url: https://docs.influxdata.com/flux/v0/stdlib/contrib/sranka/webexteams/message/
estimated_tokens: 1620
product: Flux
version: v0
---

# webexteams.message() function

-   Flux 0.125.0+
-   View InfluxDB support

`webexteams.message()` is a user-contributed function maintained by the [package author](#package-author-and-maintainer).

`webexteams.message()` sends a single message to Webex using the [Webex messages API](https://developer.webex.com/docs/api/v1/messages/create-a-message).

##### Function type signature

```js
(
    markdown: A,
    roomId: B,
    text: C,
    token: string,
    ?url: string,
) => int
```

For more information, see [Function type signatures](/flux/v0/function-type-signatures/).

## Parameters

### url

Base URL of Webex API endpoint (without a trailing slash). Default is `https://webexapis.com`.

### token

(Required) [Webex API access token](https://developer.webex.com/docs/api/getting-started).

### roomId

(Required) Room ID to send the message to.

### text

(Required) Plain text message.

### markdown

(Required) [Markdown formatted message](https://developer.webex.com/docs/api/basics#formatting-messages).

## Examples

### Send the last reported status to Webex Teams

```js
import "contrib/sranka/webexteams"
import "influxdata/influxdb/secrets"

apiToken = secrets.get(key: "WEBEX_API_TOKEN")

lastReported =
    from(bucket: "example-bucket")
        |> range(start: -1m)
        |> filter(fn: (r) => r._measurement == "statuses")
        |> last()
        |> findRecord(fn: (key) => true, idx: 0)

webexteams.message(
    token: apiToken,
    roomId: "Y2lzY29zcGFyazovL3VzL1JPT00vYmJjZWIxYWQtNDNmMS0zYjU4LTkxNDctZjE0YmIwYzRkMTU0",
    text: "Disk usage is ${lastReported.status}.",
    markdown: "Disk usage is **${lastReported.status}**.",
)
```

[single notification](/flux/v0/tags/single-notification/)