{"uid":"cap_8oUIb2f5AIUqZMpPuO3CR","slug":"palmyr-phone-call-dtmf-speech-gather-d257f903","name":"Palmyr Phone Call DTMF/Speech Gather","description":"Autonomous infrastructure for AI agents — pay with USDC on Solana or Base via x402.","url":"https://palmyr.ai/phone/calls/%7BcallControlId%7D/gather","method":"POST","headers":{},"bodySchema":{"properties":{"input":{"properties":{"body":{"type":"object","additionalProperties":true}}},"output":{"properties":{"example":{"type":"object","additionalProperties":true}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.08","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.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JMqPaI3ahlooB3tg8IX8N","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Collects DTMF tones or speech input from an active phone call by sending a gather prompt to the specified call.","exampleAgentPrompt":"On the active call with control ID 'ctrl_abc123', prompt the caller to press 1 for sales or 2 for support, and gather their keypad input.","exampleUseCases":null,"resultDescription":"Returns the gathered input from the caller — either DTMF digits pressed or transcribed speech — along with the call control ID and event metadata indicating what the caller entered in response to the prompt.","failureModes":["Call control ID not found or invalid — 404 error","Call has already ended before gather can be initiated — state conflict error","Caller does not respond within timeout window — timeout/no-input event","Payment not completed — 402 Payment Required response","Invalid gather parameters in request body — 400 Bad Request","Network or telephony provider error during gather — 5xx error"],"whenToPreferThis":"Use this endpoint when you need to interactively collect input (keypresses or speech) from a caller during an active Palmyr-managed phone call — particularly in IVR flows, menu prompts, or any step where an AI agent needs to branch logic based on caller response. Prefer this over polling-based approaches when you need real-time in-call input collection.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T09:53:22.790Z","isFirstParty":false}