Skip to main content
The Messaging API allows you to send and receive messages across multiple communication channels.
Before making your first request, it’s important to understand how the messaging ecosystem works inside Visito.

​
Messaging Ecosystem Overview

The Messaging API is built around three core concepts:

​
Channels

A channel represents a messaging endpoint such as WhatsApp Business Account, Instagram DM account, etc. Each channel has its own capabilities and requirements.

​
Contacts

A contact represents a user who can send or receive messages through a specific channel. Examples:
  • A WhatsApp contact has a phone number
  • An Instagram contact has an instagramId
  • A WebChat contact has a sessionId
  • A Messenger contact has a psid
Contacts always belong to a single channel.

​
Sending Messages

Before you can send a message, you must:
  1. List your available channels
    View the channels connected to your account.
    → List Channels
  2. Connect additional channels (WhatsApp, Instagram, Messenger)
    Follow the setup guide to add more messaging endpoints.
    → Connect Channels
  3. Create a contact
    A message must be sent to a specific contact on a specific channel.
    → Create a Contact
Once a contact exists, you can send:
  • Text messages
  • Media (images, files, audio)
  • Templates (WhatsApp)
  • Interactive messages

​
Receiving Messages

To receive inbound messages or message status updates (sent, delivered, read), you must configure webhooks. Webhook events supported:
  • New incoming messages
  • Message status updates
  • Conversation updates
  • Escalations
→ See the Webhooks guide for setup instructions.
You’re now ready to start using the Messaging API!