# DoubleTick MCP MCP

> DoubleTick manages your WhatsApp business communications through an API connection. Your AI agent can list all contacts, check opt-in status, track message delivery failures, send pre-approved templates, and pull entire conversation histories instantly.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** whatsapp-api, business-messaging, crm, customer-engagement, message-templates

## Description

Need to manage customer conversations directly from your chat interface? DoubleTick hooks up the official WhatsApp Business API into your workflow. You'll gain total visibility across every customer interaction: list all contacts, check their opt-in status, or find out if a template message actually sent successfully. The agent can pull deep details on any conversation—from listing recent messages to checking contact profiles. This MCP lets you audit entire communication campaigns and keep track of who needs follow-up. When connected via Vinkius, your AI client handles all the complex API calls, letting you focus solely on customer outcomes. It's essentially a full operations dashboard for WhatsApp, managed by conversation.

## Tools

### get_doubletick_account_metadata
Pulls metadata and usage limits for your DoubleTick account.

### get_contact_details
Retrieves detailed profile and conversation status for a single contact.

### quick_whatsapp_volume_audit
Generates a high-level summary report on messaging activity and success rates.

### list_whatsapp_contacts
Provides a list of all phone numbers registered with DoubleTick.

### list_conversation_messages
Lists all messages sent and received within a specified conversation thread.

### list_opted_in_contacts
Finds contacts who have explicitly given permission for WhatsApp communication.

### list_latest_whatsapp_messages
Identifies the most recently exchanged messages across all conversations in your account.

### list_approved_templates
Shows every WhatsApp message template that has been approved in your account.

### search_contacts_by_keyword
Searches your contact database using keywords or phone number patterns.

### send_whatsapp_template
Sends a message using one of the pre-approved WhatsApp templates to a target recipient.

## Prompt Examples

**Prompt:** 
```
List all our WhatsApp contacts.
```

**Response:** 
```
I've found several contacts, including 'John Doe' (+1 555-0123) and 'Jane Smith' (+1 555-9876). Would you like to see the last message for any of these?
```

**Prompt:** 
```
Show me the approved WhatsApp templates.
```

**Response:** 
```
I've retrieved your approved templates, including 'welcome_message', 'order_update', and 'appointment_reminder'. Would you like the full JSON structure for 'order_update' to send a message?
```

**Prompt:** 
```
Search for contact with phone number '+1 555-4444'.
```

**Response:** 
```
I've found a contact matching that number: 'Robert Brown'. He is currently 'Opted In' and his last interaction was yesterday. Should I pull his full conversation history?
```

## Capabilities

### Check Contact Details
Get a contact’s profile information and their current standing with your organization.

### Search Contacts by Keyword
Find specific contacts using either a name or phone number search query.

### List All WhatsApp Contacts
Retrieve the complete list of all registered contacts in your DoubleTick account.

### Review Conversation History
Pull a full message transcript for any specific conversation thread.

### Monitor Latest Messages
Identify the most recent messages, whether they were sent or received, across all channels.

### Send Template Message
Dispatch a message using one of your pre-approved WhatsApp templates.

### Audit Communication Volume
Get a high-level summary and success rate report for all messaging activity.

## Use Cases

### Customer Support Needs History Context
A customer calls support about an order issue. Instead of having the agent ask for a reference number, your agent uses search_contacts_by_keyword first to find the contact and then list_conversation_messages to instantly show the full chat history related to the problem.

### Marketing Checks Campaign Health
You just ran a big campaign. You ask your agent to quick_whatsapp_volume_audit. The agent immediately provides success rates and volume summaries, letting you know if the template message sending was successful without digging into metrics dashboards.

### Sales Needs Contact Validation
A lead gives a name but no number. Your agent uses get_contact_details to validate if that person exists in your system and checks their opt-in status before you waste time sending an email or message.

### Support Needs Template Confirmation
You need to send a follow-up reminder. Instead of guessing, the agent first runs list_approved_templates so you know exactly what messaging options are available before using send_whatsapp_template.

## Benefits

- Instant Status Checks: Instead of checking multiple tabs, the agent uses get_contact_details to pull a contact's status and profile info in one prompt.
- Compliance Control: List all approved templates using list_approved_templates before sending anything. This prevents accidental non-compliant messages from going out.
- Full Audit Trail: Quickly check campaign health by running quick_whatsapp_volume_audit, giving you immediate success rates across your entire user base.
- Targeted Communication: Use search_contacts_by_keyword to zero in on a specific person or group without scrolling through hundreds of contacts first.
- Deep History Retrieval: Need context? list_conversation_messages pulls the full thread history for any contact, so you never have to ask someone 'What did we talk about last week?'
- Opt-In Management: Use list_opted_in_contacts to filter your lists. This ensures you only market or communicate with people who actually want to hear from you.

## How It Works

The bottom line is, your AI client handles the API complexity so you just talk to it like you're talking to a colleague.

1. Connect the DoubleTick MCP to your AI client and authorize it using your specific API Key.
2. Tell your agent what you need—for example, 'Find out everything about John Doe' or 'List all approved templates.'
3. The agent executes the necessary tool calls, pulls data from DoubleTick, and presents a clean summary in natural language.

## Frequently Asked Questions

**How does DoubleTick MCP use the get_contact_details tool?**
The agent uses get_contact_details to pull a single contact's profile info and their current conversation status. This means you know who they are and if they’re active, all from one call.

**What is the difference between list_whatsapp_contacts and search_contacts_by_keyword?**
list_whatsapp_contacts gives you a raw dump of every number registered. You use search_contacts_by_keyword when you only know part of the information, like a name or partial phone number.

**Can I send messages without checking templates first using DoubleTick MCP?**
No. To maintain compliance and ensure delivery, you must check list_approved_templates first before sending any message via send_whatsapp_template.

**Does quick_whatsapp_volume_audit track everything that was sent?**
It provides a high-level summary of messaging activity and overall success rates. It’s the fastest way to audit campaign performance without diving into raw logs.

**How do I check my current API quotas and daily limits using get_doubletick_account_metadata?**
This tool retrieves your account's metadata, including rate limits. It shows you how many messages you have remaining for the day, helping you plan your send volume and avoid hitting hard caps.

**When I use list_conversation_messages, what exactly is included in the message history?**
It gathers all messages for a specific chat ID. The output includes both the content and metadata for every message sent or received within that single conversation thread.

**How does list_opted_in_contacts help me manage compliant communication campaigns?**
This tool filters your entire contact base, showing only users who have explicitly given consent. It’s key for ensuring you only message people allowed to receive WhatsApp communications.

**What happens if I try to send a template using send_whatsapp_template with an unapproved ID?**
The tool requires the template name and must be pre-approved. If the API finds an invalid or pending template, it immediately throws an error code, preventing any unwanted messages from being sent.

**How do I get a DoubleTick API Key?**
Log in to your DoubleTick dashboard, navigate to **Settings > API**, and you can generate or retrieve your unique API Key from there. Ensure you have an active WhatsApp Business account linked.

**Can the agent send custom text messages?**
This integration primarily uses WhatsApp templates for automated messaging to ensure compliance with official API rules. Sending non-template messages may require an active 24-hour customer service window.

**Does the integration support contact tags?**
Yes, you can use the get_contact_details tool to retrieve any tags or custom fields associated with your WhatsApp contacts.