> For the complete documentation index, see [llms.txt](https://whatsnap.gitbook.io/whatsnap-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whatsnap.gitbook.io/whatsnap-docs/conversations.md).

# Conversations

Master WhatSnap's conversation system to send messages (WhatsApp, SMS/iMessage, Twilio) through GoHighLevel,  control account routing with commands, and automate messaging workflows.

WhatSnap's conversation system transforms how you communicate across multiple messaging platforms (WhatsApp, SMS/iMessage, and Twilio SMS) by integrating seamlessly with GoHighLevel. Send messages, automate responses, and manage multi-account communications all from within your familiar GHL interface.

## Core Conversation Features

### 💬 **Native Integration**

Send and receive messages (WhatsApp, SMS/iMessage, and Twilio) directly in GoHighLevel conversations, maintaining unified communication while leveraging each platform's strengths.

### 🎛️ **Command System**

Use powerful commands like `#switch` and `#switch_unique` to dynamically control which messaging account and platform handles specific messages and conversations.

### 🤖 **Workflow Automation**

Create sophisticated automated messaging sequences, responses, and complex business logic using GoHighLevel's workflow system with multi-platform messaging integration.

### 📱 **Channel Flexibility**

Choose between SMS channel override for maximum integration or separate WhatsApp channels for distinct messaging streams.

## Conversation Workflow

{% @mermaid/diagram content="graph TD;
A\["📨 Message Received"] --> B{Channel Type?};
B -->|"📱 SMS Override"| C\["📱 Appears in SMS Tab"];
B -->|"💬 Separate Channel"| D\["💬 Appears in WhatsApp Tab"];

```
C --> E["⚙️ Process Message"];
D --> E;

E --> F{Contains Command?};
F -->|"✅ Yes"| G["🎛️ Execute Command"];
F -->|"❌ No"| H["📝 Normal Processing"];

G --> I["🔀 Route Message"];
H --> I;

I --> J{Automated Response?};
J -->|"🤖 Yes"| K["⚡ Trigger Workflow"];
J -->|"👤 No"| L["✍️ Manual Response"];

K --> M["🤖 Send Automated Reply"];
L --> N["👤 User Composes Reply"];

M --> O["✅ Message Delivered"];
N --> O;

classDef startEnd fill:#e3f2fd,stroke:#1976d2,stroke-width:3px,color:#000000;
classDef process fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px,color:#000000;
classDef decision fill:#e8f5e8,stroke:#00695c,stroke-width:2px,color:#000000;
classDef automation fill:#e1f5fe,stroke:#3f51b5,stroke-width:2px,color:#000000;

class A,O startEnd;
class C,D,E,H,I,L,N process;
class B,F,J decision;
class G,K,M automation;" %}
```

## Key Conversation Areas

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>💬 Messaging Basics</strong></td><td>Learn how to send and receive WhatsApp messages through GoHighLevel</td><td><a href="/whatsnap-docs/conversations/messaging-basics.md">Messaging Basics</a></td></tr><tr><td><strong>🎛️ Commands System</strong></td><td>Master dynamic account switching and message routing with special commands</td><td><a href="/whatsnap-docs/conversations/commands-system.md">Command System</a></td></tr><tr><td><strong>🤖 Workflow Automation</strong></td><td>Automate WhatsApp messaging with GoHighLevel workflows and advanced triggers</td><td><a href="/whatsnap-docs/conversations/workflow-automation.md">Workflow Automation</a></td></tr></tbody></table>

## Channel Integration Options

### SMS Channel Override (Recommended)

{% hint style="success" %}
**Maximum Integration**: Override your SMS channel to use WhatsApp messages in existing workflows without modification.
{% endhint %}

**Benefits:**

* All SMS workflow actions work instantly with WhatsApp
* Existing automations continue working seamlessly
* Maximum feature compatibility with GHL
* Unified conversation experience

### Separate WhatsApp Channel

{% hint style="info" %}
**Parallel Messaging**: Keep SMS and WhatsApp as separate channels for distinct use cases.
{% endhint %}

**Benefits:**

* Maintain both SMS and WhatsApp capabilities
* Clear separation between message types
* Channel-specific automations possible
* Gradual transition flexibility

## Command System Highlights

### Essential Commands

* **`#switch [account-tag]`**: Permanently change which messaging account handles a contact
* **`#switch_unique [account-tag]`**: Send single message from different account without changing association

### Command Benefits

* **Dynamic Routing**: Route messages to specific accounts and platforms on demand
* **Account Testing**: Test different accounts and platforms without permanent changes
* **Conversation Control**: Override automatic account selection when needed
* **Invisible to Recipients**: Commands are processed internally and not shown to contacts
* **Platform Switching**: Seamlessly switch between WhatsApp, SMS/iMessage, and Twilio

## Automation Capabilities

### Available Automations

* **Message Sending**: Trigger WhatsApp messages from workflows
* **Response Detection**: Wait for and process WhatsApp replies
* **Conditional Logic**: Branch workflows based on message content
* **Contact Management**: Auto-assign contacts based on interactions
* **Tag Operations**: Add/remove tags based on WhatsApp activity

### Advanced Features

* **Webhook Integration**: Custom integrations via incoming/outgoing webhooks
* **Multi-account Logic**: Distribute automated messages across accounts
* **Custom Variables**: Personalize messages with contact data
* **Timing Controls**: Schedule messages and control send rates

## Communication Strategies

### Customer Support

Use WhatsApp for:

* **Real-time Support**: Instant responses with high open rates
* **Issue Resolution**: Visual communication with screenshots/videos
* **Follow-up Sequences**: Automated check-ins and satisfaction surveys

### Sales Conversations

Leverage WhatsApp for:

* **Lead Qualification**: Interactive conversations with prospects
* **Product Demos**: Share media and links seamlessly
* **Closing Sequences**: Automated follow-up until conversion

### Marketing Engagement

Optimize WhatsApp for:

* **Content Distribution**: Share valuable content directly
* **Event Promotions**: Invite contacts to webinars and events
* **Feedback Collection**: Gather reviews and testimonials

## Best Practices

### Message Quality

* **Personal Tone**: Write messages as if from a real person
* **Natural Language**: Avoid overly promotional or robotic language
* **Relevant Timing**: Respect time zones and communication preferences
* **Value-First**: Provide value before making requests

### Account Management

* **Warm Accounts**: Use accounts that have established conversation history
* **Rotation Strategy**: Distribute conversations across multiple accounts
* **Status Monitoring**: Regularly check account health and connectivity
* **Backup Plans**: Have alternative accounts ready if primary accounts have issues

### Automation Strategy

* **Progressive Engagement**: Start with simple automations before complex sequences
* **Human Handoff**: Plan for transferring conversations to human agents
* **Testing First**: Test all automated sequences with small groups
* **Response Monitoring**: Track response rates and engagement metrics

## Getting Started with Conversations

{% stepper %}
{% step %}

#### Choose Your Integration Method

Decide between [SMS channel override or separate WhatsApp channels](/whatsnap-docs/conversations/messaging-basics.md) based on your needs.
{% endstep %}

{% step %}

#### Learn Basic Messaging

Master the fundamentals of [sending and receiving WhatsApp messages](/whatsnap-docs/conversations/messaging-basics.md) through GoHighLevel.
{% endstep %}

{% step %}

#### Explore Commands

Discover how to use the [command system](/whatsnap-docs/conversations/commands-system.md) for dynamic account routing and message control.
{% endstep %}

{% step %}

#### Implement Automation

Set up [workflow automation](/whatsnap-docs/conversations/workflow-automation.md) to scale your WhatsApp communications efficiently.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Ready to communicate?** With proper conversation management, you can deliver personalized WhatsApp experiences at scale while maintaining the human touch that drives engagement.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://whatsnap.gitbook.io/whatsnap-docs/conversations.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.