--- title: Mastodon  description: The Mastodon Call Routing Plugin is a Taalk Certified integration designed to facilitate real-time voice call routing through Mastodon’s infrastructure, using a lightweight and secure proxy endpoint. This plugin enables AI Agents within the Taalk ecosystem to dynamically route voice engagements—both inbound and outbound—based on customer, campaign, or agent-specific criteria. --- [Skip to content](https://knowledge.taalk.ai/mastodon-call-routing-plugin#main-content) Open main navigation Close main navigation How can we help you today? - There are no suggestions because the search field is empty. 1. [Taalk Academy](https://knowledge.taalk.ai/?hsLang=en) 2. [Automation](https://knowledge.taalk.ai/automation?hsLang=en) 3. [Native Integration](https://knowledge.taalk.ai/automation?hsLang=en#native-integration) April 9, 2025 # Mastodon  The Mastodon Call Routing Plugin is a Taalk Certified integration designed to facilitate real-time voice call routing through Mastodon’s infrastructure, using a lightweight and secure proxy endpoint. This plugin enables AI Agents within the Taalk ecosystem to dynamically route voice engagements—both inbound and outbound—based on customer, campaign, or agent-specific criteria. This integration is ideal for businesses using Mastodon for telecom orchestration, carrier-level control, or lead delivery compliance workflows. **Use Case** With AI Agents handling millions of customer conversations monthly, Taalk supports complex engagement orchestration across voice, SMS, and email channels. For customers leveraging Mastodon for telecom routing, this plugin enables: •Real-time call forwarding based on call direction (inbound vs. outbound) •Precise lead-to-call correlation using unique identifiers •Custom routing via agency\_name or carrier flags •Secure and auditable delivery via Taalk’s proxy infrastructure ---   **Endpoint** **`POST https://post.xxxx.net/xmlPosts/mastodon-proxy.php`** **Required Query Parameters** | **Parameter** | **Type** | **Description** | | --- | --- | --- | | api\_key | string | The API key used to authenticate the request (provided by Mastodon or intermediary service) | | leadtype | string | Type or classification of the lead (e.g., “auto”, “health”, “home”) | | source\_token | string | Token identifying the lead source, assigned by the campaign or partner | | leadid | string | Unique lead ID from the Taalk system () | | lendor\_id | int | ID used to tag and attribute the carrier/lender involved (typically 1 unless otherwise instructed) | | carrier | string | Agency name or carrier reference (e.g., Other, AgencyABC) | | call\_type | string | Specifies the direction of the call: "inbound" or "outbound" |     ---   **Dynamic Value Generation**   Within Taalk’s runtime, these fields are often dynamically populated based on the AI Agent’s context or engagement metadata: ``` call_type = callDirection === "OUT" ? "outbound" : "inbound"; ``` This ensures the right routing context is applied for AI-driven conversations that either initiate calls (e.g., proactive outreach) or receive inbound callbacks.   ---   **Example Request** **POST https://post.xxxxx.net/xmlPosts/mastodon-proxy.php?api\_key=ABC123KEY&leadtype=auto&source\_token=tok123abc &leadid=&\_lendor\_id=1&carrier=Other&call\_type=outbound** **Response Format** Responses from this proxy typically return XML or status codes indicating: •Success (200 OK with routing confirmation) •Auth failure (401 Unauthorized) •Invalid payload or field (400 Bad Request) •System error (500 Internal Server Error) If needed, responses can be transformed internally within Taalk for JSON consumption. --- **Integration Best Practices** •**API Key Security**: Store and rotate api\_key values securely; avoid hardcoding them into public environments. •**Field Mapping**: Ensure consistent lead metadata mappings between Taalk and Mastodon to avoid mismatches. •**Monitoring**: Track proxy responses and use Taalk dashboards or logs to monitor failure rates or call drops. •**Fallback Logic**: Implement retry or escalation paths if Mastodon proxy responses fail or exceed latency thresholds. --- **Troubleshooting** | **Issue** | **Possible Cause** | **Resolution** | | --- | --- | --- | | 401 Unauthorized | Incorrect or expired api\_key | Check key validity with your Mastodon or intermediary admin | | 400 Bad Request | Missing or malformed parameter | Validate all fields, especially leadid and call\_type | | No Response / Timeout | Mastodon endpoint down or unreachable | Retry after 30s or contact infrastructure support | **Support** For setup assistance, parameter mapping help, or escalation of plugin issues, reach out to your assigned **Taalk Solutions Engineer** or email us at [success@taalk.ai](mailto:success@taalk.ai). - [Getting Started](https://knowledge.taalk.ai/getting-started?hsLang=en#main-content) - [Platform 101](https://knowledge.taalk.ai/getting-started?hsLang=en#platform-101) - [Campaign 101](https://knowledge.taalk.ai/getting-started?hsLang=en#campaign-101) - [AI Workforce](https://knowledge.taalk.ai/getting-started?hsLang=en#ai-workforce) - [Operator Force](https://knowledge.taalk.ai/getting-started?hsLang=en#operator-force) - [Billing 101](https://knowledge.taalk.ai/getting-started?hsLang=en#billing-101) - [Compliance 101](https://knowledge.taalk.ai/getting-started?hsLang=en#compliance-101) - [AI Force](https://knowledge.taalk.ai/ai-force?hsLang=en#main-content) - [Agent Behavior](https://knowledge.taalk.ai/ai-force?hsLang=en#agent-behavior) - [Objective and Scripts](https://knowledge.taalk.ai/ai-force?hsLang=en#objective-and-scripts) - [Agent Call Flow and Transfers](https://knowledge.taalk.ai/ai-force?hsLang=en#agent-call-flow-and-transfers) - [Agent Knowledge](https://knowledge.taalk.ai/ai-force?hsLang=en#agent-knowledge) - [Agent Multichannel Playbooks](https://knowledge.taalk.ai/ai-force?hsLang=en#agent-multichannel-playbooks) - [Agent Plugins](https://knowledge.taalk.ai/ai-force?hsLang=en#agent-plugins) - [Best Practices](https://knowledge.taalk.ai/ai-force?hsLang=en#best-practices) - [Templates](https://knowledge.taalk.ai/ai-force?hsLang=en#templates) - [Operator Force](https://knowledge.taalk.ai/operator-force?hsLang=en#main-content) - [Operator](https://knowledge.taalk.ai/operator-force?hsLang=en#operator) - [Admin](https://knowledge.taalk.ai/operator-force?hsLang=en#admin) - [Contact Center](https://knowledge.taalk.ai/contact-center?hsLang=en#main-content) - [Campaign](https://knowledge.taalk.ai/contact-center?hsLang=en#campaign) - [Taalk Dialer](https://knowledge.taalk.ai/contact-center?hsLang=en#taalk-dialer) - [Metrics & Reporting](https://knowledge.taalk.ai/contact-center?hsLang=en#metrics-reporting) - [Templates](https://knowledge.taalk.ai/contact-center?hsLang=en#templates) - [Best Practices](https://knowledge.taalk.ai/contact-center?hsLang=en#best-practices) - [Automation](https://knowledge.taalk.ai/automation?hsLang=en#main-content) - [OpenAPI](https://knowledge.taalk.ai/automation?hsLang=en#openapi) - [Native Integration](https://knowledge.taalk.ai/automation?hsLang=en#native-integration) - [Compliances](https://knowledge.taalk.ai/compliances?hsLang=en#main-content) - [Company DNC](https://knowledge.taalk.ai/compliances?hsLang=en#company-dnc) - [TCPA](https://knowledge.taalk.ai/compliances?hsLang=en#tcpa) - [Best Practices](https://knowledge.taalk.ai/compliances?hsLang=en#best-practices) - [Teleco Trust](https://knowledge.taalk.ai/compliances?hsLang=en#teleco-trust) - [Product Updates](https://knowledge.taalk.ai/product-updates?hsLang=en#main-content) - [W9-2025](https://knowledge.taalk.ai/product-updates?hsLang=en#w9-2025) - [W8-2025](https://knowledge.taalk.ai/product-updates?hsLang=en#w8-2025) - [W10-2025](https://knowledge.taalk.ai/product-updates?hsLang=en#w10-2025) - [W11-2025](https://knowledge.taalk.ai/product-updates?hsLang=en#w11-2025) - [W12-2025](https://knowledge.taalk.ai/product-updates?hsLang=en#w12-2025) - [W13-2025](https://knowledge.taalk.ai/product-updates?hsLang=en#w13-2025) - [W14-2025](https://knowledge.taalk.ai/product-updates?hsLang=en#w14-2025) - [W15-2025](https://knowledge.taalk.ai/product-updates?hsLang=en#w15-2025) - [W16-2025](https://knowledge.taalk.ai/product-updates?hsLang=en#w16-2025) [![Taalk](https://knowledge.taalk.ai/hs-fs/hubfs/logo%20taalk.png?width=60&height=60&name=logo%20taalk.png "Taalk")](https://knowledge.taalk.ai/?hsLang=en) [mailto:success@taalk.ai](mailto:success@taalk.ai) Copyright © 2025 Taalk LLC