# Zenvia Conversion MCP MCP > Zenvia Conversion handles everything from initial contact to qualified lead status. Use this MCP to manage leads and messages in real time via your AI client. You can track full interaction histories, create new prospects, send free-text WhatsApp replies, or even blast out structured message templates—all without leaving the chat window. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** whatsapp-api, lead-management, conversational-sales, omnichannel-support, customer-engagement, messaging-automation ## Description You automate sales and support workflows straight from natural conversation by connecting your Zenvia Conversion account to any AI agent. Instead of juggling multiple tabs, you manage leads directly within your primary workspace. You can pull a list of all prospects or dive deep into one person's entire interaction history. Need to follow up? Send free-text messages or use structured message templates like WhatsApp HSMs. The platform handles the complexity; you just talk to it. Because this MCP runs on Vinkius, your credentials pass through a zero-trust proxy, meaning your keys never sit unsecured on a disk—it’s secure for complex operations. This capability means you can combine Zenvia Conversion with other systems, like billing or support platforms, all within one single AI agent chat. ## Tools ### create_lead Adds a new prospect into Zenvia Conversion with provided contact details and initial notes. ### get_account Retrieves high-level information about the entire account setup in Zenvia. ### get_prospect Gets comprehensive profile data for a specific prospect, including key metrics and statuses. ### list_agents Lists all user agents that have access to the account within Zenvia Conversion. ### list_groups Provides a list of predefined agent groups used for team organization. ### list_interactions Shows every recorded interaction log associated with a specific prospect over time. ### list_labels Retrieves all the custom labels or tags used to categorize prospects and leads. ### list_prospects Generates a list of every current prospect within the entire Zenvia Conversion system. ### send_message Sends an immediate, custom free-text message to any specified prospect. ### send_template Dispatches a pre-approved, structured message template (HSM) to a specific prospect. ## Prompt Examples **Prompt:** ``` List all active prospects in Zenvia Conversion. ``` **Response:** ``` I've retrieved your prospects. You have 12 active conversations. The most recent interactions are with 'John Doe' (Status: Hot) and 'Jane Smith' (Status: Follow-up needed). ``` **Prompt:** ``` Create a new lead for 'Alice' with phone +5511988887777. ``` **Response:** ``` Successfully created the lead for Alice. She has been added to your inbox and is now visible as a new prospect. Would you like to send her a template message? ``` ## Capabilities ### New Lead Creation Creates a new prospect in Zenvia using provided contact details and an initial message. ### Prospect Data Retrieval Fetches detailed information about any specific prospect by name or ID. ### Interaction Logging Retrieves a full, chronological log of all past messages and activities for a given prospect. ### Outreach Messaging Sends immediate, free-text replies to an active WhatsApp conversation or initiates one using specific message templates. ### Account Structure Overview Lists existing groups, labels, and agents within the account to maintain team clarity. ## Use Cases ### The Cold Lead Follow-up A sales rep finds a new contact. They run get_prospect to verify the account status, use list_interactions to see if they talked before, and then send_template to initiate a professional first touch. ### The Support Escalation A support agent receives an inquiry. They check get_account for billing details, use list_labels to confirm the customer's service tier, and then respond using send_message. ### Bulk Prospect Identification The marketing team needs a report. They execute list_prospects to get all contacts, filter them by status, and use create_lead for any that need immediate follow-up attention. ### Team Handoff Coordination An account manager finishes their day. They use list_agents and list_groups to document which team members are responsible for the assigned leads, ensuring a smooth handover for the next shift. ## Benefits - Maintain perfect context: Instead of digging through emails, you can use list_interactions to view a prospect’s full history in one go. This keeps your conversations informed and professional. - Streamline outreach: When you need to follow up, you don't have to manually type everything out; you can send_message or send_template instantly using natural language prompts. - Never lose a lead: If an inbound query comes in, use create_lead to capture all the details right away. The prospect is immediately visible and ready for action. - Know your team structure: Use list_agents or list_groups to quickly verify who owns which leads or if there are any internal process gaps. - Auditability built-in: Every single tool call, whether it's get_prospect or send_message, is recorded in a cryptographically signed audit trail. Nothing happens outside of the system. - Efficiency boost: Vinkius handles token optimization on every API call, meaning you cut down on unnecessary costs while running complex tasks. ## How It Works The bottom line is that once connected, your AI agent uses the Zenvia APIs to perform complex sales tasks simply based on natural language commands. 1. Subscribe to this MCP and enter your Zenvia Conversion API key via the Vinkius platform. 2. Connect your preferred client (like Cursor or Claude) to the Vinkius catalog. The connection handles all credential security in transit. 3. Ask your agent a question, like 'List all prospects who haven't talked in 30 days,' and it executes the workflow for you. ## Frequently Asked Questions **How do I check all the interactions with one prospect using list_interactions?** You simply prompt your agent to run list_interactions for that specific ID or name. It pulls every recorded chat, status change, and message into your current conversation window. **Can I create a new lead using the create_lead tool?** Yes, you can. Just tell your agent to use create_lead and provide the contact details and any initial notes you want associated with that new prospect record. **What's the difference between send_message and send_template?** send_message is for ad-hoc, free-text chat replies. send_template is required when you need to use a pre-approved, structured message format like those used in WhatsApp. **How do I see all my current prospects using list_prospects?** Ask your agent to run list_prospects. It will pull the roster of every prospect currently tracked within Zenvia Conversion, which you can then filter or analyze. **How do I use list_agents to see all team members in my account?** It retrieves a roster of every agent associated with your Zenvia Conversion account. This lets you quickly check who is available for support or assignment management. **If I know a prospect's ID, how do I use get_prospect to pull all their detailed information?** This function provides comprehensive data on one specific prospect. You can access details that go beyond basic status, including full contact info and key metrics for better context. **What is the purpose of list_labels? ** It fetches all organizational labels used in your Zenvia Conversion system. These labels let you categorize, group, or filter large numbers of prospects efficiently. **How do I use get_account to verify my connection and account status?** It returns core information about the connected Zenvia Conversion account itself. Running this confirms your API key is active and provides basic operational parameters right away. **What is the difference between a Lead and a Prospect?** In Zenvia Conversion, a Lead is an initial contact entry. Once a lead is processed or created via the API, it becomes a Prospect in your CRM pipeline. **Can I start a WhatsApp conversation with a new number?** Yes, but you must use an approved HSM template to initiate a new conversation. Free-text messages can only be sent to active conversations within the 24-hour window.