Overview

Steps to setup Quick Replies

Chat with us

Blog

API Collection

Periskope Docs

Docs

APIs & Webhooks

Dashboard

Postman API collection

Support

Setup quick replies for frequent queries from customers

Setup Quick Replies

Your guide to get up and running with Periskope WhatsApp platform

Introduction

Guide to setting up your organization account on Periskope

Setting up your account

Guide to connecting your WhatsApp numbers to Periskope

Connect WhatsApp to Periskope

Most common use cases for Periskope across industries, verticals and geographies

Common Use Cases

Connect and manage multiple WhatsApp numbers from a single dashboard

Multi-number inbox

Give multiple users access to manage, view and respond to messages without being on WhatsApp

Multi-agent access

Walkthrough of the layout and features of the Chats screen

View & Manage Chats

Guide to schedule and send bulk messages to multiple WhatsApp groups & 1:1 chats with custom text, video, images

Sending a Bulk Message

Guide to personalise bulk messages with variables

Variables in Bulk Messages

Guide to creating templates for recurring use for bulk-messaging

Creating Message Templates

Guide to view bulk message logs, and stop and restart ongoing bulk messages

Bulk Message Logs

Intuitively organize chats, contacts and tickets with custom labels

Organize chats with labels

Intuitively organize groups & chats with custom properties

Organize chats with custom properties

Guide to view and understand WhatsApp usage metrics via the Periskope dashboard

Key Usage Metrics

Guide to easily add, remove, promote, demote members across mutlitple WhatsApp groups

Bulk WhatsApp Actions

Export chat data, group members, contact attributes and files

Manage & Export Data

Walkthrough of the layout and features of the Contacts screen

View & Manage Contacts

Store frequently used media and docs on Periskope for ease of access.

Media Library

Guide to create and manage tickets/tasks on WhatsApp groups and 1:1 chats

Create a ticket from any WhatsApp message

Guide to creating tickets directly from WhatsApp groups with an emoji

Create a ticket with an emoji

Guide to automatically flag important messages with Periskope AI

Flag important messages with AI

Guide to inviting your team, and provide role-based access to groups

Invite Team

Guide to giving restricted access to teams to view and reply on WhatsApp via Periskope

Manage Team Access

Walkthrough of the layout and features of the Chat-List screen

Chat List

Walkthrough of the layout of the settings screens

Settings

Guide to connect your HubSpot account with Periskope

HubSpot

Guide to setup zapier triggers on Periskope

Zapier

Guide to connect Periskope with Google Sheets using webhooks

Google Sheets

Guide to setup Authentication on Periskope

Create a Chat

Get chat info by ID 

 Refer [Chat](https://docs.periskope.app/api-reference/objects/the-chat-object) object to find more details about `chat object`.

Retrieve a Chat

Lists all chats

Refer [Chat](https://docs.periskope.app/api-reference/objects/the-chat-object) object to find more details about `chat object`.

List all Chats

List all the chat messages associated to the chat_id. 

 Refer [Message](https://docs.periskope.app/api-reference/objects/the-message-object) object to find more details about `message object`.

List all chat messages by Chat ID

List all chat labels. 

 Refer [Labels](https://docs.periskope.app/api-reference/objects/the-label-object) object to find more details about `label object`.

List all org labels (Chat)

Update chat labels

**This `API` replaces all the current labels on provided Chat IDs with the new labels**

Update chat labels by Chat IDs

List all chat custom properties. 

 Refer [Custom Property](https://docs.periskope.app/api-reference/objects/the-custom-property-object) object to find more details about `custom property object`.

List all org custom properties (Chat)

Update chat custom properties

**Returns the status**

Update chat custom properties by Chat IDs

Add participants to group. This operation requires the connected phone to be an admin in the group.

**Participants will only be added if they have allowed addition to groups. If they can't be added automatically, they will receive an invite to join the group**

Add member to group

Remove participants from a group. This operation requires the connected phone to be an admin in the group.

**Participants will only be removed if they are NOT the owner of the group.

Remove member from group

Promote participants in a group. This operation requires the connected phone to be an admin in the group.



Promote member in group to admin

Demote participants in a group. This operation requires the connected phone to be an admin in the group.



Demote admin in group to member

Update group settings e.g. member permissions, group image, title or description. This operation requires the connected phone to be an admin in the group.



Change group settings

Send a text or media message to a chat

The chat_id for an individual chat is of the following format: (country_code + phone_number + @c.us). e.g. The chat_id for +91 90043 89567 is 919004389372@c.us

For a group chat, you need to fetch the chat_id (it will end in @g.us). You can fetch this in the settings sidepanel on Periskope (or by right-clicking on any chat and copying the id)

 Returns `sent_message_id` for the message. This can be used to get message status using [Get Message By ID](https://docs.periskope.app/api-reference/message/get-message) API

Send a message

Broadcast a message

Get message status by message_id. 

 Refer [Message](https://docs.periskope.app/api-reference/objects/the-message-object) object to find more details about `message object`. 

 Any of - `message_id` | `sent_message_id` | `unique_id` can be used for getting the message. 

1. When getting a ticket info, `quoted_message_id` in ticket object is the `unique_id` of the message.

2. When sending a message, `sent_message_id` is returned in the response. 

 3. When listing a chat messages, `message_id` is returned in the response object.

Get message

Edit a message. 

 Editing message body is only possible for a short duration after the message is sent

Edit a message

Forward a message to chat_ids. 

 Forwarding is limited by WA to a select set of chats. If you would like to send to more chats, use broadcasts

Forward a message

Delete a message. 

 Message deletion is only allowed for upto 48 hours of sending the message (and if you have the required permissions)

Delete a message

React to a message. 

 Reaction should be sent as a supported emoji. To delete a reaction, send a blank string instead

React to a message

Get all contacts

Update contact details like name and internal status

Update contact

Update contact labels

**This `API` replaces all the current labels on provided Contact IDs with the new labels**

Update contacts labels

Get ticket info by ID 

 Refer [Ticket info](https://docs.periskope.app/api-reference/objects/the-ticket-info-object) object to find more details about `ticket info object`.

Get ticket info

List all ticket labels 

 Refer [Label object](https://docs.periskope.app/api-reference/objects/the-label-object) object to find more details about `label object`.

List all org labels (ticket)

Get message queue

Purge message queue

Get phone info 

 Refer [Phone object](https://docs.periskope.app/api-reference/objects/the-phone-object) object to find more details about `phone object`.

Get phone

Update phone

Restart phone

Resync phone

The `chat.created` webhook is triggered when a new group or individual chat is created on whatsapp.

chat.created

The `chat.notification.created` webhook is triggered when any action is performed on a chat. For e.g. when a member is added or removed from a chat, when group settings is updated.

chat.notification.created

The `message.created` webhook is triggered when a new message is received or sent on whatsapp.

message.created

The `message.updated` webhook is triggered when a message is edited on whatsapp.

message.updated

The `message.deleted` webhook is triggered when a message is deleted on whatsapp.

message.deleted

The `message.ack.updated` webhook is triggered when a new message is received or sent on whatsapp.

message.ack.updated

The `reaction.created` webhook is triggered when a reaction is created on Whatsapp.

reaction.created

The `reaction.updated` webhook is triggered when a reaction is updated on Periskope.

reaction.updated

The `ticket.created` webhook is triggered when a new ticket is created on Periskope.

ticket.created

The `ticket.updated` webhook is triggered when ticket details are updated on Periskope.

ticket.updated

The `ticket.deleted` webhook is triggered when a ticket is deleted on Periskope.

ticket.deleted

The Chat object represents a chat in WhatsApp.

The Chat Object

The Chat Notification object represents a chat update notification in WhatsApp.

The Chat Notification Object

The Reaction object represents a message reaction in WhatsApp.

The Reaction Object

The message object represents a message sent or receive on WhatsApp.

The Message Object

The custom property object represents a custom property for a chat on Periskope.

The Custom property Object

The Label object represents a label on Periskope.

The Label Object

The Ticket Info Object represents a ticket on Periskope.

The Ticket Object

The Phone object represents an organisation phone on Periskope.

Get Started

Manage WhatsApp Groups & 1:1 Chats

Create Tickets and Tasks

Manage Team Access

Walktroughs

Integrations

Setup Quick Replies

Overview

Steps to setup Quick Replies

Get Started

Manage WhatsApp Groups & 1:1 Chats

Create Tickets and Tasks

Manage Team Access

Walktroughs

Integrations

​Overview

​Steps to setup Quick Replies

Overview

Steps to setup Quick Replies