PubNub Logo Docs
Support Contact Sales Login Try Our APIs

›Admin Portal

Collapse all
Dark mode

Home

  • Home

First steps

  • Set up your account
  • Get the SDK
  • Initialize PubNub
  • Identify users and devices
  • Send messages
  • Receive messages
  • Retrieve old messages
  • Check user presence
  • Add custom metadata
  • Manage access
  • React to events
  • Add serverless business logic
  • Send push notifications

Admin Portal

  • Basics
  • Apps
  • Keysets
  • Functions
  • Usage

Setup

  • PubNub account
  • Application
  • Users & devices
  • Connection management
  • Data security
  • Data persistence
  • API limits

Chat

  • In-App Chat

SDKs

  • SDKs

Messages

  • Publish
  • Receive
  • Actions
  • Payload type conventions

Channels

  • Basics
  • Subscription
  • Naming conventions

User presence

  • Basics
  • Events
  • State
  • Webhooks

Metadata

  • Channel
  • User
  • Membership

Message Persistence

  • Message Persistence

File sharing

  • File sharing

Access management

  • Manage access

Push notifications

  • Basics
  • iOS
  • Android
  • Troubleshooting

Best practices

  • Architectural choices
  • Message aggregation
  • Friend list & status feed
  • Troubleshooting
  • Migration guides

Serverless processing

    EVENTS & ACTIONS

    • Basics
    • Configure Events & Actions

    FUNCTIONS

    • Basics
    • Development guidelines
    • Functions API
    • Custom integrations

Debug Console
Network Status

Functions

Functions enable you to write code or leverage existing integrations to address your business needs, without the need to spin up your own servers or incur an increased latency through call-outs to an external server or serverless technology. The code you write or use runs within PubNub's operational environment, giving you the scale and speed that you need for your applications.

Modules

To create a function you need to first create a module. Think of a module as a container for your functions.

To create a Module:

  1. Choose an app with a corresponding keyset.

  2. Fill in the mandatory Name field and the optional Description field.

Portal with no modules

For further information on how to create functions, refer to the Serverless processing section.

Statistics

You can select the module to view all functions that have been created inside of it.

Portal with available functions

At first glance, you can see whether a module is Running or Stopped. You can also see a number of metrics related to functions inside that module:

Functions statistics

NameDescription
TotalThe number of created functions inside the module.
RunningAll functions in the module are running and operational.
FailedOne or more functions in the module failed to run because of an error, and all functions are stopped. Check the logs for more information.
StoppedNone of the functions in the module are running. Messages will pass through the PubNub network without triggering your saved Functions.
PendingFunctions in the module are being started. This is a transient state and the module may remain in this state for up to 20 seconds.

Functions overview

This section gives you an overview of all functions that may be available in a module:

Functions overview inside module

NameDescription
FunctionName of your function.
EventEvent type tied to your function.
Channels/Path/IntervalConfiguration parameters of your function.
StateState of your function. Refer to the previous table to view available states.
Log levelLog output configuration. Available log levels include: Debug, Log, Assert, Warn, Error.

Third-party services integration

Apart from creating a function by yourself, you can also leverage existing third-party integrations, including but not limited to language translation, sentiment analysis, SMS, text-to-speech, and content moderation. You can do that by clicking on the Import Block button inside a module. This takes you to the Integrations catalog outside of Admin Portal where you can view all possible integrations or read a brief overview of required dependencies. After you choose an integration to import, it will open in a new tab.

Function configuration view

You can click one of the functions inside the module to open the function configuration view. This view gives you the ability to configure your function, change its code as well as rename it, specify which channel the function uses, or test your function. The view is divided into the following sections:

  • Function parameters
  • Code editor
  • Console view

Configure view of the function

Function parameters

You can configure the following parts of your function:

NameConfigurable items
NameCurrent name of the function.
Event typeEvent type of the currently selected function.
Log levelLog output. Available log levels include: Debug, Log, Assert, Warn, Error.
ChannelChannel the function runs on.
URI PathA suffix that is added to the full URL path at which your On Request function is triggered. For example, if you specify the URI Path as hello, your function will be triggered once you send a request to https://ps.pndsn.com/v1/blocks/sub-key/{your-sub-key}/hello.
Test payloadTest message payload. Its initial structure changes based on the event type of the selected function. You can change the payload to suit your needs.
My SecretsCredentials configuration. You can store secrets and use them in the function body.

Code editor

Use it to create or modify the code responsible for your function. The example code differs between function event types and is based on the one you select when you first create a function. If you change the function event type from the drop-down list in the function parameters section, the code will not refresh.

For further information on how to create functions, refer to the Creating a function section.

Console view

Displays debug information about your module and function. You can show all filters, clear the console, or filter the view by selecting one or more of the following:

Filter nameDisplayed information
Module statusThe deployment status and deployment regions.
Channel statusThe channel your function runs on.
Console outputThe output logged to the console from within your function body.
Test messagesType and body of published messages set in the Test payload section.
Wildcard channels

Wildcard channels won't work inside the code editor, you have to provide a specific channel.

← KeysetsUsage →
  • Modules
    • Statistics
    • Functions overview
    • Third-party services integration
  • Function configuration view
    • Function parameters
    • Code editor
    • Console view
© PubNub Inc. - Privacy Policy