{"uid":"cap_0dQK1Nl9VbRCeHQV3i8Qo","slug":"agentline-webhook-registration-for-ai-phone-agent-37ccfdf9","name":"AgentLine Webhook Registration for AI Phone Agent","description":"Get a real phone number for your AI agent in under 10 minutes. Works with OpenClaw, Hermes Agent, and any LLM. Outbound calls, SMS, and inbound voice — one API. No telecom experience needed.","url":"https://api.agentline.cloud/v1/x402/webhooks/test","method":"POST","headers":{},"bodySchema":{"type":"object","required":["url","phone_number"],"properties":{"url":{"type":"string","description":"HTTPS URL receiving the agent's events as signed JSON POSTs"},"secret":{"type":"string","description":"HMAC signing secret (auto-generated if omitted)"},"phone_number":{"type":"string","description":"Your wallet-owned number whose agent gets the webhook"},"signature_header":{"type":"string","description":"HMAC header name (default 'X-Webhook-Signature')"}}},"responseSchema":{"type":"object","properties":{"sent":{"type":"boolean"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5n82MeCwnjDJF7Zk_RDLk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Registers a webhook URL to receive signed event notifications for a wallet-owned AI agent phone number, enabling real-time call and SMS event delivery.","exampleAgentPrompt":"Register a webhook for my AI agent's phone number +14155550123 — send all call and SMS events to https://myserver.example.com/agent-events and auto-generate an HMAC signing secret for me.","exampleUseCases":[{"title":"Inbound call routing for voice agent","prompt":"Set up a webhook for my AI agent's phone number +14155550123 so that all inbound call events get POSTed to https://myapp.com/voice-events — use the header name X-AgentLine-Sig and generate a signing secret automatically."},{"title":"SMS event forwarding for support agent","prompt":"Register my support agent's number +12125550199 to push all SMS events to https://support.myco.io/sms-hook with HMAC signing secret 'sup3rs3cret' so my backend can verify the payloads."},{"title":"Multi-agent event bus integration","prompt":"I want all call and message events for the agent number +18005550101 forwarded to https://events.myplatform.dev/agentline-inbound — please auto-generate the signing secret and use the default signature header."}],"resultDescription":"A confirmation of the webhook registration, including the assigned webhook ID, the phone number it is bound to, the target URL, and the HMAC signing secret (either provided or auto-generated) to be used for verifying incoming event payloads.","failureModes":["Invalid or non-HTTPS webhook URL returns a 400 validation error","Phone number not owned by the authenticated wallet returns a 403 forbidden error","Duplicate webhook registration for the same number and URL may return a conflict error","Malformed phone number format causes a 422 unprocessable entity error","Payment of $0.01 USDC not received or insufficient funds causes a 402 payment required response"],"whenToPreferThis":"Choose this endpoint when you need to receive real-time call and SMS event notifications for a wallet-owned AI agent phone number via a signed webhook, rather than polling for events. Ideal for LLM-based voice agents built on OpenClaw, Hermes, or similar frameworks that need event-driven triggers to handle inbound interactions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T14:50:08.984Z","isFirstParty":false}