{"uid":"cap_34a8Qzi_1HHfIG_qcCGEp","slug":"klearflow-revenue-recovery-decision-engine-11606300","name":"KlearFlow Revenue Recovery Decision Engine","description":"Machine-paid revenue intelligence and recovery APIs. Discovery is free; successful execution is paid in Base USDC through x402.","url":"https://klearflow.vercel.app/api/relay/v1/recover-revenue?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"industry":{"type":"string","description":"Optional business industry."},"eventType":{"enum":["missed_call","stale_lead","quote_unanswered","appointment_no_show","payment_failed"],"type":"string","description":"The revenue event that needs a recovery decision."},"bookingUrl":{"type":"string","description":"Optional booking URL to include for rescheduling or callbacks."},"paymentUrl":{"type":"string","description":"Optional secure retry URL for failed-payment recovery."},"businessName":{"type":"string","description":"Optional business name."},"priorAttempts":{"type":"number","maximum":100,"minimum":0,"description":"Number of prior recovery attempts."},"preferredChannel":{"enum":["auto","sms","email","phone_task"],"type":"string","description":"Preferred recovery channel or auto-selection."},"customerFirstName":{"type":"string","description":"Optional first name for message personalization."},"minutesSinceEvent":{"type":"number","maximum":5256000,"minimum":0,"description":"Minutes elapsed since the revenue event occurred."},"averageOpportunityValue":{"type":"number","maximum":10000000,"minimum":0,"description":"Estimated value of the opportunity in USD."}}},"responseSchema":{"type":"json","example":{"result":{"mode":"decision_packet","safety":{"externalActionExecuted":false,"requiresCallerExecution":true},"priority":"immediate","economics":{"modelType":"heuristic","opportunityValue":1200,"expectedRecoverableValue":420,"modeledRecoveryProbability":0.35},"shouldAct":true,"capability":"recover_revenue","recommendedAction":{"channel":"sms","message":"Hi Sam, thanks for calling Example HVAC Co. Sorry we missed you. What can we help with?","actionType":"acknowledge_and_reopen","executeWithinMinutes":5}},"payment":{"payer":"0x0000000000000000000000000000000000000000","network":"eip155:8453","protocol":"x402","transaction":"0x0000000000000000000000000000000000000000000000000000000000000000"},"proofId":"00000000-0000-4000-8000-000000000000","priceUsd":0.05,"chargedUnit":"recovery_decision"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Qlv3gDYsoV03uhC1nxUHO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a revenue loss event (missed call, stale lead, failed payment, etc.) and returns a prioritized, channel-specific recovery action with economic modeling of recoverability.","exampleAgentPrompt":"A customer named Sam missed a call to my HVAC business, Comfort Air Solutions, about 8 minutes ago — the job is worth roughly $1,200 and this is the first time we've tried to reach them. What's the best way to recover this and what should I say via SMS?","exampleUseCases":[{"title":"Missed call follow-up for service business","prompt":"A potential customer called my plumbing company, FastFlow Plumbing, 12 minutes ago and we missed it — their job is probably worth about $800 and we haven't tried calling back yet. Should we text or call them, and what should we say?"},{"title":"Failed payment recovery for subscription SaaS","prompt":"A customer named Jordan just had a payment fail on their $350/month subscription — it happened 5 minutes ago and we've never attempted recovery before. We have a secure retry link. What channel and message should we use to get them to pay?"},{"title":"Unanswered quote follow-up for a contractor","prompt":"We sent a $4,500 renovation quote to a lead named Maria 3 days ago — that's 4,320 minutes — and she hasn't responded. This is our second attempt. Should we email, SMS, or assign a phone task, and what should we say to reopen the conversation?"}],"resultDescription":"Returns a structured decision packet including: whether to act (shouldAct), priority level (e.g. immediate), a recommended channel (sms/email/phone_task), a personalized recovery message, action type, time window to execute within, economic modeling (opportunity value, expected recoverable value, modeled recovery probability), and a safety flag confirming the action requires caller execution rather than being auto-executed.","failureModes":["Invalid eventType enum value returns a 400 validation error","minutesSinceEvent or averageOpportunityValue out of allowed range returns a 400 error","Missing required eventType field returns a 400 bad request","Payment not completed (x402 flow incomplete) results in a 402 Payment Required response","Network or server error on the upstream model returns a 500 with no decision packet","priorAttempts exceeding 100 triggers a validation rejection"],"whenToPreferThis":"Choose this endpoint when you need a data-driven, economics-aware recommendation for how to recover a specific revenue loss event in real time. It is preferable to generic CRM follow-up rules because it models recoverability probability, selects the optimal channel, and generates a personalized message — all in one call. Best suited for AI agents embedded in sales workflows, CRM automations, or customer success systems that need to act within minutes of a revenue event.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-03T00:34:46.451Z","isFirstParty":false,"canonicalSlug":"klearflow-revenue-recovery-decision-engine-11606300"}