.mint-block {
    display: block
}
.mint-rounded-xl {
    border-radius: 0.75rem
}
.mint-border {
    border-width: 1px
}
.mint-shadow {
    --tw-shadow: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1);
    --tw-shadow-colored: 0 1px 3px 0 var(--tw-shadow-color), 0 1px 2px -1px var(--tw-shadow-color);
    box-shadow: var(--tw-ring-offset-shadow, 0 0 #0000), var(--tw-ring-shadow, 0 0 #0000), var(--tw-shadow)
}

Overview

Steps to Export Tickets

Export Format

Note

Export Tickets

Periskope Docs

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

Essential best practices and recommendations for safe WhatsApp outreach

Best Practices for WhatsApp Outreach

A guide on warming up new numbers to improve the behavior scores and avoid bans

Warming Up New Numbers

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

Intuitively organize chats, contacts and tickets with labels and custom properties

Labels

Learn how to create and manage custom properties for WhatsApp chats and tickets

Custom Properties

Setup quick replies for frequent queries from customers

Quick Replies

Schedule one-time and recurring messages to be sent automatically to your customers

Scheduled & Recurring Messages

Simple way for your team to communicate internally on WhatsApp groups and chats without the end user ever knowing

Private Notes

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

WhatsApp Analytics

Export chat data, group members, contact attributes and files

WhatsApp Data Exports

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

Create a Ticket on WhatsApp

Guide to creating tickets directly from WhatsApp groups with an emoji

Create Ticket with an Emoji

Guide to create and manage tasks and reminders on WhatsApp groups, 1:1 chats, messages or tickets

Create a Task

Guide to add reminders to a task on Periskope

Set Reminders for Tasks

Guide to use task filters/sorting, task actions, and task details on Periskope

Task Actions (filters, sorting & actions)

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

Guide to automatically flag important messages with Periskope AI

Flag Messages with AI

Guide to generate chat summaries and craft contextual responses with Periskope AI

AI Summaries and Responses

Guide to setup and train AI to respond and manage conversations on your behalf on WhatsApp

AI Agent

Ask questions and take action on your Whatsapp using AI tools

Periskope Whatsapp MCP

Automation rules is a powerful feature in Periskope that allow you to automate your monitoring and alerting workflows. You can create rules that trigger actions based on specific conditions.

What are Automation Rules?

Components of Automation Rules

Triggers

Conditions

Actions

Guide to set up automation rules in Periskope

Setting up Automation Rules

Guide to connect your HubSpot account with Periskope

HubSpot

Google Sheets

Guide to setup Freshdesk Integration on Periskope

Freshdesk

Guide to setup Zohodesk Integration on Periskope

Zohodesk

Guide to setup zapier triggers on Periskope

Zapier

Guide to enable Periskope notifications on different devices

Fix "Not receiving notifications on Periskope"

Guide to fix app crashes across different devices

Fix "Can't use Periskope due to App crashes"

Guide to fix app crashes across different browsers

Fix "Blank screen or Out of memory issues"

Guide to fix chats not loading issue on different browsers

Fix "Chats not loading"

Automate your WhatsApp with Periskope APIs

How to authenticate your requests to Periskope

Authorization

Build with Periskope using our Typescript SDK

This endpoint retrieves a specific chat from its chat_id


Get Chat By ID

This endpoint retrieves a paginated list of all messages for the specific chat_id (in descending order of timestamp)


Get Messages in a Chat

This endpoint retrieves a paginated list of all notifications for the specific chat_id (in descending order of timestamp)


Get Notifications in a Chat

This endpoint retrieves a paginated list of chats


List All Chats

This endpoint retrieves a paginated list of all messages across chats (in descending order of timestamp)


List All Messages

This endpoint retrieves a paginated list of all notifications across chats (in descending order of timestamp)


List All Notifications

This endpoint updates the labels for specific chats


Update Chat Labels

This endpoint updates properties of a chat


Update Chat

This endpoint marks a unread chat as read.

Mark chat as read

This endpoint creates a new group.
 - Note that creating a new 1-1 chat does not require any explicit API. Sending a message will automatically create the chat

Create Group

Generate a new invite link for a chat

This endpoint adds a participant to a group

_Note that adding unknown numbers is a spammy action and can result in a ban_

_Per Meta's policies, a user will be added to a group directly only if they have enabled it in their privacy settings, and they are a member of your phone contacts_

_For all other cases, this will send an invite to them to join the group_


Add Participant to Group

This endpoint removes a participant from a group


Remove Participant from Group

This endpoint promotes a participant in a group to admin


Promote Participant to Admin

This endpoint demotes a participant in a group to member


Demote Participant to Member

This endpoint updates the settings of the group


Update Group Settings

This endpoint is used to send a message to a chat


Send Message

This endpoint is used to send bulk messages to many chats


Broadcast Message

This endpoint deletes a message based on the `message_id` or `queue_id` to be deleted


Delete Message

This endpoint edits a message based on the `message_id` or `queue_id`


Edit Message

This endpoint forwards a message to other chats


Forward Message

This endpoint retrieves a specific message based on the `message_id` or `queue_id`


Get Message

This endpoint reacts to a message based on the `message_id` or `queue_id`


React to Message

This endpoint retrieves a specific contact along with all associated `chat_ids` (1-1 chats and common groups).


Get Contact By ID

This endpoint retrieves a paginated list of contacts


Get Contacts

This endpoint updates the labels for specific contacts


Update Contact Labels

This endpoint updates properties of a contact


Update Contact

Create Contact

This endpoint retrieves a specific ticket along with the associated chat, and messages


Get Ticket By ID

This endpoint retrieves a paginated list of tickets


Get Tickets

This endpoint updates properties of a ticket


Update Ticket

Create Ticket

This endpoint returns the jobs currently in the queue


Fetch Queue Jobs

Retrieves the status of a broadcast message by its ID

Get Broadcast Status

This endpoint returns the current status of the message queue

Get Queue Status

This endpoint purges the jobs in the queue

#### Request Params

- `queue_id` _(string, optional)_
    
    - Provide the queue_id of the message to purge only that job
        
- `broadcast_id` _(string, optional)_
    
    - Provide the broadcast_id to purge all messages of that broadcast
        

If no params are provided, this will purge all the message jobs in the queue

Purge Queue

This endpoint retrieves information about the phone (specified in the x-phone header)

Get phone

This endpoint retrieves a list of all phones associated with this account

#### Response

The response is a JSON array of phone objects. Refer to [the phone object here](/api-reference/objects/the-phone-object)

Get All Phones

This endpoint retrieves the QR code of the phone (specified in the x-phone header).

- Note: QR code will only be available when the phone is in a DISCONNECTED state
    
- If the QR is not available, you can reset the phone to generate a fresh QR

Get QR

This endpoint will logout the session and reset the phone connection to the QR state.

**Note: You will need to rescan the QR code to establish the connection**

Reset Phone

This endpoint restarts the phone connection

Restart Phone

This endpoint is triggers a resynchronization of all data between the phone and WhatsApp

Resync Phone

This endpoint updates properties of the phone


Update phone

This endpoint will create a new phone for your organization

Create Phone

This endpoint will delete the phone from your organization

Delete Phone

Listen to events on Periskope and build your custom integrations

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 `message.flagged` webhook is triggered when a message is flagged on Periskope.

message.flagged

The `message.unflagged` webhook is triggered when a message is unflagged on Periskope.

message.unflagged

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.

Get Started

Manage WhatsApp Groups, 1:1 Chats & Communities

Tickets, Tasks and Reminders

Bulk Messages

AI Automation for WhatsApp

Automation Rules

Integrations

Troubleshooting

Export Tickets

Overview

Steps to Export Tickets

Export Format

Note

Get Started

Manage WhatsApp Groups, 1:1 Chats & Communities

Tickets, Tasks and Reminders

Bulk Messages

AI Automation for WhatsApp

Automation Rules

Integrations

Troubleshooting

​Overview

​Steps to Export Tickets

​Export Format

​Note

Overview

Steps to Export Tickets

Export Format

Note