Attach a phone number to an inbound agent in the Ringg agent editor, and choose the caller ID for outbound calls and campaigns with from_number_id or a pool.
A number in your workspace does nothing until an agent uses it, and the two directions work differently: inbound is set once and stays; the outbound is picked every time a call is placed.In the dashboard: Sidebar → Assistants → your agent → Attach Number.
Attaching a number to the inbound Support line agent
1
Open Attach Number
Open the agent. In a single-prompt agent, expand Attach Number under Call Settings in the editor sidebar. In a multi-prompt agent, open Attach number in the global settings.
Open Inbound Number (“Select a phone number to receive inbound calls”) and choose a number, for example +91 98765 43210. There is no separate save step.
The Inbound Number list
You see “Number has been attached successfully”.
An attached number
Inbound Number lists only numbers that:
are not attached to another agent,
have inbound calling enabled (on by default; contact Ringg to change it), and
match the agent’s channel (phone numbers for voice agents, WhatsApp numbers for WhatsApp agents).
If the list is empty, it shows “Buy numbers to attach”. The last option, Add Number, opens the Numbers page.One agent has one inbound number, and one number serves one agent; the Used By column on the Numbers page shows which. Picking a different number replaces the old one, which stays in your workspace with no agent. Attaching takes the number out of its number pool, and an attached number can’t join one; attaching fails while a campaign is scheduled or running on that pool.Attach Number appears on inbound and WhatsApp single-prompt agents and on every multi-prompt agent. An outbound agent’s Inbound Calling switch changes its type to outbound-inbound but does not add an Attach Number panel; to answer calls on a number, use an inbound agent.
In the agent editor, clear the Inbound Number field. You see “Number has been detached successfully”.
Or on the Numbers page, click Detach Number in the Used By column and confirm Detach.
The number stays in your workspace and joins your Default pool. Detaching fails with “This workspace has no default number pool yet. Please create one.” when there is no Default pool, and while a campaign is scheduled or running on the Default pool.
For a number on your own telephony account, the provider must route its calls to Ringg:
Plivo, Twilio and Vobiz: Ringg links the number to its app in your provider account when you attach it. Plivo and Twilio numbers are unlinked again when you detach them.
VoiceLink: Ringg routes the number when you import or buy it.
Exotel: attach the number to the Ringg Inbound applet in Exotel yourself (Exotel).
Telnyx: assign the number to your Voice API Application in the Telnyx portal (Telnyx).
InTalk: set the static WSS URL in InTalk’s portal (InTalk).
Other providers: set the routing in the provider’s console. Ozonetel’s URLs are on its guide; for the rest, contact Ringg.
Choose a number (“The number assistant will call from.”). It lists Test numbers, Your numbers, and In use numbers (attached to an agent, shown but disabled).
The Select number card: Individual numbers (pick one or more; each shows its provider and a Spam chip if flagged) or Number pool to rotate across a pool. Test numbers are not listed.
API call
from_number_id, from_number or number_pool_id (below).
A caller number with country code, for example +919876500001, or an array of numbers.
Initiate Individual Call (Number Pool) also accepts number_pool_id (Copy pool ID on the pool list). Send at least one of the three; with a pool, the pool is used and the other field is ignored.When no pool is sent, default outbound numbers set on the agent version take precedence over from_number_id and from_number.
For campaigns, Start Campaign takes from_numbers (an array of number IDs, or numbers written exactly as listed in your workspace; each retry dials from the next one) and Start Campaign (Number Pool) takes number_pool_id.
The number is attached. On the Numbers page, the Used By column should show your agent. If it shows another agent, detach it there and attach it to the right one.
The agent takes inbound calls. An outbound agent has no Attach Number panel (which agents do).
The provider routes the number to Ringg. For your own telephony, finish the provider-side routing.
Look in Logs. If the call appears in Logs, it reached Ringg and the agent’s settings are the next place to look. If it doesn’t, the call never reached Ringg; check the number with your provider.
My number isn't in the Inbound Number list
Check that Telephony is set to the account the number belongs to, and that the number meets the three conditions above.
The test call says to use the IN or US test number
Test numbers are region-bound. The Indian test number calls Indian numbers only; the US test number calls numbers outside India. Click Switch or pick one of your own numbers. See Test numbers.
The API returns an error about the caller number
Send from_number_id or from_number, not both. Sending neither returns 400 unless the agent version has default outbound numbers. On Initiate Individual Call (Number Pool), both together or none of the three returns 422.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ringg AI","description":"Build AI agents that make and answer phone calls, talk on your website and chat on WhatsApp, then run them from the Ringg AI dashboard or REST API.","colors":{"primary":"#0A0A0B","light":"#FFFFFF","dark":"#0A0A0B"},"logo":{"light":"https://mintcdn.com/ringgai-0da73d20/ZLVFI55VhZ4gmYrF/logo/light.svg?fit=max\u0026auto=format\u0026n=ZLVFI55VhZ4gmYrF\u0026q=85\u0026s=053f22dbaf5140cd8e5dadb1d4d057cd","dark":"https://mintcdn.com/ringgai-0da73d20/ZLVFI55VhZ4gmYrF/logo/dark.svg?fit=max\u0026auto=format\u0026n=ZLVFI55VhZ4gmYrF\u0026q=85\u0026s=cf9075384ec572e1a19b939d5a8674af","href":"https://www.ringg.ai"},"favicon":"https://mintcdn.com/ringgai-0da73d20/ZLVFI55VhZ4gmYrF/favicon.svg?fit=max\u0026auto=format\u0026n=ZLVFI55VhZ4gmYrF\u0026q=85\u0026s=e612fcf76df43d6468baa340dc3fde50","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","python","javascript"]},"mdx":{"auth":{"method":"key","name":"X-API-KEY"},"server":"https://prod-api.ringg.ai/ca/api/v0"}},"appearance":{"default":"dark"},"background":{"decoration":"grid"},"navbar":{"links":[{"href":"/resources/learn/all-lessons","label":"Learn"},{"href":"mailto:admin@ringg.ai","label":"Contact us"}],"primary":{"type":"button","label":"Dashboard","href":"https://www.ringg.ai/dashboard"}},"footer":{"socials":{"x":"https://x.com/ringg_ai","linkedin":"https://www.linkedin.com/company/ringg","youtube":"https://www.youtube.com/@RinggAI","instagram":"https://www.instagram.com/ringg_ai","discord":"https://discord.gg/YuEnb8Vsca"},"links":[{"header":"For AI agents","items":[{"label":"llms.txt","href":"https://docs.ringg.ai/llms.txt"},{"label":"skill.md","href":"https://docs.ringg.ai/skill.md"},{"label":"OpenAPI spec","href":"https://docs.ringg.ai/api-reference/openapi.json"},{"label":"MCP server","href":"/resources/mcp-server/docs-mcp-server/mcp-for-ai-assistants"}]}]},"search":{"prompt":"Search the docs"},"seo":{"metatags":{"canonical":"https://docs.ringg.ai","og:site_name":"Ringg AI Docs","twitter:site":"@ringg_ai"},"organization":{"id":"https://www.ringg.ai/#organization","legalName":"Stoic AI Private Limited","url":"https://www.ringg.ai","logo":"https://assets.ringg.ai/images/logo/logo.svg","sameAs":["https://x.com/ringg_ai","https://www.linkedin.com/company/ringg","https://www.youtube.com/@RinggAI","https://www.instagram.com/ringg_ai","https://discord.gg/YuEnb8Vsca"]}},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","latex":false},"errors":{"404":{"redirect":false,"title":"This page doesn't exist","description":"It may have moved in the docs rebuild. The suggestions below usually have it; otherwise start from [the introduction](/get-started/ringg-ai) or search above."}},"contextual":{"options":["copy","view","chatgpt","claude","mcp","download-spec"],"display":"header"},"markdown":{"instructions":["To search or read these docs, connect the Ringg docs MCP server at https://docs.ringg.ai/mcp (no key needed; tools search_ringg_ai and query_docs_filesystem_ringg_ai) instead of browsing pages one by one. Setup for each client: https://docs.ringg.ai/resources/mcp-server/docs-mcp-server/mcp-for-ai-assistants.md","The dashboard labels agents \"Assistants\"; these docs say \"agent\". Both mean the same object, identified by agent_id.","API base URL: https://prod-api.ringg.ai/ca/api/v0. Send the workspace API key in the X-API-KEY header, from server-side code only.","Placing a call dials a real phone number and spends credits. Confirm the number with the user before calling.","To act on a Ringg workspace (place calls, edit agents, read transcripts), use the separate Ringg workspace MCP server at https://mcp.ringg.ai/mcp: https://docs.ringg.ai/resources/mcp-server/workspace-mcp-server/overview.md"]},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ringgai-0da73d20","hasAudioNarration":false,"actualSubdomain":"ringgai-0da73d20","customDomains":["docs.ringg.ai"],"gitSource":{"type":"github","owner":"stonkr","repo":"ringg-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true,"edits":true,"issues":true},"entitlements":{},"buildId":"6adb52e21a579503f2299e23","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"Documentation","count":90},{"language":"default","tag":"API reference","count":52},{"language":"default","tag":"Build agents","count":37},{"language":"default","tag":"Resources","count":34},{"language":"default","tag":"Learn","count":27},{"language":"default","tag":"Inventory","count":23},{"language":"default","tag":"Deploy","count":22},{"language":"default","tag":"Customize agent behaviour","count":19},{"language":"default","tag":"Agents","count":17},{"language":"default","tag":"Calling","count":15}],"searchSettings":{"showContentSnippets":true,"maxResults":8}},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"img.nav-logo{height:1.375rem!important;width:auto!important}.figure-card{display:flex;flex-direction:column;margin:0.5rem 0;overflow:hidden;border:1px solid rgb(10 10 11 / 0.08);border-radius:1rem;background:#ffffff;text-decoration:none!important;transition:border-color 150ms}.figure-card:hover{border-color:rgb(10 10 11 / 0.2)}.dark .figure-card{border-color:rgb(255 255 255 / 0.08);background:rgb(var(--background-dark))}.dark .figure-card:hover{border-color:rgb(255 255 255 / 0.2)}.figure-card-panel{display:flex;justify-content:center;height:12rem;margin:0.375rem 0.375rem 0;border-radius:0.75rem;-webkit-mask-image:linear-gradient(to bottom, #000 62%, transparent);mask-image:linear-gradient(to bottom, #000 62%, transparent);background:#f6f6f7 url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='384' height='256' fill='none' stroke='%230a0a0b' stroke-opacity='0.03' stroke-width='1.5'%3E%3Ccircle cx='32' cy='32' r='25'/%3E%3Ccircle cx='96' cy='32' r='25'/%3E%3Crect x='135' y='7' width='50' height='50' rx='8'/%3E%3Ccircle cx='224' cy='32' r='25'/%3E%3Ccircle cx='288' cy='32' r='25'/%3E%3Ccircle cx='352' cy='32' r='25'/%3E%3Ccircle cx='32' cy='96' r='25'/%3E%3Ccircle cx='96' cy='96' r='25'/%3E%3Ccircle cx='160' cy='96' r='25'/%3E%3Ccircle cx='224' cy='96' r='25'/%3E%3Ccircle cx='288' cy='96' r='25'/%3E%3Ccircle cx='352' cy='96' r='25'/%3E%3Ccircle cx='32' cy='160' r='25'/%3E%3Crect x='71' y='135' width='50' height='50' rx='8'/%3E%3Ccircle cx='160' cy='160' r='25'/%3E%3Ccircle cx='224' cy='160' r='25'/%3E%3Crect x='263' y='135' width='50' height='50' rx='8'/%3E%3Crect x='327' y='135' width='50' height='50' rx='8'/%3E%3Crect x='7' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='96' cy='224' r='25'/%3E%3Crect x='135' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='224' cy='224' r='25'/%3E%3Crect x='263' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='352' cy='224' r='25'/%3E%3C/svg%3E\") center / 192px 128px}.dark .figure-card-panel{background:#0f0f11 url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='384' height='256' fill='none' stroke='%23ffffff' stroke-opacity='0.025' stroke-width='1.5'%3E%3Ccircle cx='32' cy='32' r='25'/%3E%3Ccircle cx='96' cy='32' r='25'/%3E%3Crect x='135' y='7' width='50' height='50' rx='8'/%3E%3Ccircle cx='224' cy='32' r='25'/%3E%3Ccircle cx='288' cy='32' r='25'/%3E%3Ccircle cx='352' cy='32' r='25'/%3E%3Ccircle cx='32' cy='96' r='25'/%3E%3Ccircle cx='96' cy='96' r='25'/%3E%3Ccircle cx='160' cy='96' r='25'/%3E%3Ccircle cx='224' cy='96' r='25'/%3E%3Ccircle cx='288' cy='96' r='25'/%3E%3Ccircle cx='352' cy='96' r='25'/%3E%3Ccircle cx='32' cy='160' r='25'/%3E%3Crect x='71' y='135' width='50' height='50' rx='8'/%3E%3Ccircle cx='160' cy='160' r='25'/%3E%3Ccircle cx='224' cy='160' r='25'/%3E%3Crect x='263' y='135' width='50' height='50' rx='8'/%3E%3Crect x='327' y='135' width='50' height='50' rx='8'/%3E%3Crect x='7' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='96' cy='224' r='25'/%3E%3Crect x='135' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='224' cy='224' r='25'/%3E%3Crect x='263' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='352' cy='224' r='25'/%3E%3C/svg%3E\") center / 192px 128px}.figure-card-panel{--hairline-plate: #f6f6f7}.dark .figure-card-panel{--hairline-plate: #0f0f11}.figure-card-panel>[data-hairline]{width:13.75rem}.figure-card-text{flex:1;padding:0.25rem 1.25rem 1.25rem}.figure-card-title{font-weight:600;color:rgb(17 24 39)}.dark .figure-card-title{color:rgb(255 255 255)}.figure-card-body{margin-top:0.25rem;font-size:0.9375rem;line-height:1.6;color:rgb(75 85 99)}.dark .figure-card-body{color:rgb(161 161 170)}"}],"page":{"pagePath":"documentation/inventory/phone-numbers/inbound-agent-number","slug":"/documentation/inventory/phone-numbers/inbound-agent-number","pageMetadata":{"title":"Inbound agent number","sidebarTitle":"Inbound agent number","description":"Attach a phone number to an inbound agent in the Ringg agent editor, and choose the caller ID for outbound calls and campaigns with from_number_id or a pool.","boost":4,"og:title":"Attach a number to an agent and set outbound caller ID","href":"/documentation/inventory/phone-numbers/inbound-agent-number"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Attach a phone number to an inbound agent in the Ringg agent editor, and choose the caller ID for outbound calls and campaigns with from_number_id or a pool.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,Check,CodeBlock,CodeGroup,Columns,Frame,Heading,OptimizedImage,ResponseField,Step,Steps,Table,Tooltip}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!Check)_missingMdxReference(`Check`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tooltip)_missingMdxReference(`Tooltip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A number in your workspace does nothing until an agent uses it, and the two directions work differently: inbound is set once and stays; the outbound `,_jsx(Tooltip,{tip:`The number the person you call sees on their phone.`,children:`caller ID`}),` is picked every time a call is placed.`]}),`\n`,_jsxs(_components.p,{children:[`In the dashboard: `,_jsxs(_components.strong,{children:[`Sidebar → Assistants → `,_jsx(_components.em,{children:`your agent`}),` → Attach Number`]}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`An agent`,icon:`bot`,href:`/documentation/build-agents/agents/create-an-agent`,horizontal:true,children:_jsxs(_components.p,{children:[`For inbound, an agent that takes inbound calls (`,_jsx(_components.a,{href:`/documentation/build-agents/agents/agent-types#agent-types-by-channel`,children:`agent types`}),`).`]})}),_jsx(Card,{title:`A number`,icon:`hash`,href:`/documentation/inventory/phone-numbers/buy-or-import-a-number`,horizontal:true,children:_jsx(_components.p,{children:`Bought or imported into your workspace.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`inbound-attach-a-number`,children:`Inbound: attach a number`}),`\n`,_jsx(Frame,{caption:`Attaching a number to the inbound Support line agent`,children:_jsx(`video`,{alt:`Attaching a number to the inbound Support line agent`,\"aria-label\":`Attaching a number to the inbound Support line agent`,controls:true,muted:true,playsInline:true,className:`mint-w-full mint-rounded-xl`,style:{aspectRatio:`16 / 10`},preload:`metadata`,controlsList:`nodownload noremoteplayback`,poster:`/media/numbers-attach/poster.webp`,children:_jsx(`source`,{src:`https://mintcdn.com/ringgai-0da73d20/XUOcNie5hfK3q--Y/media/numbers-attach/video.webm?fit=max\u0026auto=format\u0026n=XUOcNie5hfK3q--Y\u0026q=85\u0026s=1bf4af95491e61a77b8772e52cca9252`,type:`video/webm; codecs=\"av01.0.09M.08\"`,\"data-path\":`media/numbers-attach/video.webm`})})}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Attach Number`,children:_jsxs(_components.p,{children:[`Open the agent. In a single-prompt agent, expand `,_jsx(_components.strong,{children:`Attach Number`}),` under `,_jsx(_components.strong,{children:`Call Settings`}),` in the editor sidebar. In a `,_jsx(_components.a,{href:`/documentation/build-agents/agents/multi-prompt-agents/overview`,children:`multi-prompt agent`}),`, open `,_jsx(_components.strong,{children:`Attach number`}),` in the global settings.`]})}),_jsx(Step,{title:`Filter by telephony (optional)`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Telephony`}),` narrows the list to `,_jsx(_components.strong,{children:`Ringg`}),` numbers or to one of your `,_jsx(_components.a,{href:`/documentation/inventory/phone-numbers/buy-or-import-a-number#connect-a-provider-account-first`,children:`connected provider accounts`}),`.`]})}),_jsxs(Step,{title:`Pick the number`,children:[_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Inbound Number`}),` (“Select a phone number to receive inbound calls”) and choose a number, for example `,_jsx(_components.code,{children:`+91 98765 43210`}),`. There is no separate save step.`]}),_jsx(Frame,{caption:`The Inbound Number list`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/ringgai-0da73d20/XUOcNie5hfK3q--Y/media/numbers-attach/number-list.webp?fit=max\u0026auto=format\u0026n=XUOcNie5hfK3q--Y\u0026q=85\u0026s=bb28cd09e01c9710c146490b0390fccf`,alt:`Agent editor for Support line with Attach Number expanded in the sidebar, Telephony set to Ringg and the Inbound Number list open showing two numbers and Add Number`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`media/numbers-attach/number-list.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ringgai-0da73d20/XUOcNie5hfK3q--Y/media/numbers-attach/number-list.webp?w=280\u0026fit=max\u0026auto=format\u0026n=XUOcNie5hfK3q--Y\u0026q=85\u0026s=7f64901f945872a29d249431ae76c546 280w, https://mintcdn.com/ringgai-0da73d20/XUOcNie5hfK3q--Y/media/numbers-attach/number-list.webp?w=560\u0026fit=max\u0026auto=format\u0026n=XUOcNie5hfK3q--Y\u0026q=85\u0026s=65b48194ce37197c47998cf04bc4f8d5 560w, https://mintcdn.com/ringgai-0da73d20/XUOcNie5hfK3q--Y/media/numbers-attach/number-list.webp?w=840\u0026fit=max\u0026auto=format\u0026n=XUOcNie5hfK3q--Y\u0026q=85\u0026s=c6241baa39a107275aab6d0fb3386a1a 840w, https://mintcdn.com/ringgai-0da73d20/XUOcNie5hfK3q--Y/media/numbers-attach/number-list.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=XUOcNie5hfK3q--Y\u0026q=85\u0026s=a968b9b5d5b985a7de48c9c4b520eaf7 1100w, https://mintcdn.com/ringgai-0da73d20/XUOcNie5hfK3q--Y/media/numbers-attach/number-list.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=XUOcNie5hfK3q--Y\u0026q=85\u0026s=c7621f38a0b64fe450dfa5271eda0ba7 1650w, https://mintcdn.com/ringgai-0da73d20/XUOcNie5hfK3q--Y/media/numbers-attach/number-list.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=XUOcNie5hfK3q--Y\u0026q=85\u0026s=37132c9f9e5986001a573d6a915b40d4 2500w`})}),_jsx(Check,{children:_jsx(_components.p,{children:`You see “Number has been attached successfully”.`})}),_jsx(Frame,{caption:`An attached number`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/ringgai-0da73d20/XUOcNie5hfK3q--Y/media/numbers-attach/attached.webp?fit=max\u0026auto=format\u0026n=XUOcNie5hfK3q--Y\u0026q=85\u0026s=7d954f2338c3e134963b934153811f6b`,alt:`Attach Number panel with Telephony Ringg and Inbound Number +919876541209 selected`,\"data-og-width\":`596`,width:`596`,\"data-og-height\":`650`,height:`650`,\"data-path\":`media/numbers-attach/attached.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ringgai-0da73d20/XUOcNie5hfK3q--Y/media/numbers-attach/attached.webp?w=280\u0026fit=max\u0026auto=format\u0026n=XUOcNie5hfK3q--Y\u0026q=85\u0026s=f6d597db4beb42c668d3f95e6d66dd6e 280w, https://mintcdn.com/ringgai-0da73d20/XUOcNie5hfK3q--Y/media/numbers-attach/attached.webp?w=560\u0026fit=max\u0026auto=format\u0026n=XUOcNie5hfK3q--Y\u0026q=85\u0026s=920cccaab0d1d8e5c683c993f4f5c003 560w, https://mintcdn.com/ringgai-0da73d20/XUOcNie5hfK3q--Y/media/numbers-attach/attached.webp?w=840\u0026fit=max\u0026auto=format\u0026n=XUOcNie5hfK3q--Y\u0026q=85\u0026s=122331bc3b31161a260a2f390fb27370 840w, https://mintcdn.com/ringgai-0da73d20/XUOcNie5hfK3q--Y/media/numbers-attach/attached.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=XUOcNie5hfK3q--Y\u0026q=85\u0026s=caa96f5c987bb02e2b77cadad2faa05a 1100w, https://mintcdn.com/ringgai-0da73d20/XUOcNie5hfK3q--Y/media/numbers-attach/attached.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=XUOcNie5hfK3q--Y\u0026q=85\u0026s=a91d23b6f48ac614c979956325accbf3 1650w, https://mintcdn.com/ringgai-0da73d20/XUOcNie5hfK3q--Y/media/numbers-attach/attached.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=XUOcNie5hfK3q--Y\u0026q=85\u0026s=bef0851df59b41b09420029cd66663fd 2500w`})})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Inbound Number`}),` lists only numbers that:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`are not attached to another agent,`}),`\n`,_jsx(_components.li,{children:`have inbound calling enabled (on by default; contact Ringg to change it), and`}),`\n`,_jsx(_components.li,{children:`match the agent’s channel (phone numbers for voice agents, WhatsApp numbers for WhatsApp agents).`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`If the list is empty, it shows “Buy numbers to attach”. The last option, `,_jsx(_components.strong,{children:`Add Number`}),`, opens the Numbers page.`]}),`\n`,_jsxs(_components.p,{children:[`One agent has one inbound number, and one number serves one agent; the `,_jsx(_components.strong,{children:`Used By`}),` column on `,_jsx(_components.a,{href:`/documentation/inventory/phone-numbers/overview#the-numbers-page`,children:`the Numbers page`}),` shows which. Picking a different number replaces the old one, which stays in your workspace with no agent. Attaching takes the number out of its `,_jsx(_components.a,{href:`/documentation/inventory/phone-numbers/number-pools`,children:`number pool`}),`, and an attached number can’t join one; attaching fails while a campaign is scheduled or running on that pool.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Attach Number`}),` appears on inbound and WhatsApp single-prompt agents and on every multi-prompt agent. An outbound agent’s `,_jsx(_components.strong,{children:`Inbound Calling`}),` switch changes its type to outbound-inbound but does not add an `,_jsx(_components.strong,{children:`Attach Number`}),` panel; to answer calls on a number, use an inbound agent.`]}),`\n`,_jsx(Heading,{level:`3`,id:`detach-a-number`,children:`Detach a number`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`In the agent editor, clear the `,_jsx(_components.strong,{children:`Inbound Number`}),` field. You see “Number has been detached successfully”.`]}),`\n`,_jsxs(_components.li,{children:[`Or on the Numbers page, click `,_jsx(_components.strong,{children:`Detach Number`}),` in the `,_jsx(_components.strong,{children:`Used By`}),` column and confirm `,_jsx(_components.strong,{children:`Detach`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The number stays in your workspace and joins your `,_jsx(_components.a,{href:`/documentation/inventory/phone-numbers/number-pools#the-default-pool`,children:`Default pool`}),`. Detaching fails with “This workspace has no default number pool yet. Please create one.” when there is no Default pool, and while a campaign is scheduled or running on the Default pool.`]}),`\n`,_jsx(Heading,{level:`3`,id:`provider-side-routing`,children:`Provider-side routing`}),`\n`,_jsx(_components.p,{children:`For a number on your own telephony account, the provider must route its calls to Ringg:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Plivo, Twilio and Vobiz`}),`: Ringg links the number to its app in your provider account when you attach it. Plivo and Twilio numbers are unlinked again when you detach them.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`VoiceLink`}),`: Ringg routes the number when you import or buy it.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Exotel`}),`: attach the number to the `,_jsx(_components.code,{children:`Ringg Inbound`}),` applet in Exotel yourself (`,_jsx(_components.a,{href:`/documentation/inventory/phone-numbers/your-own-telephony/exotel`,children:`Exotel`}),`).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Telnyx`}),`: assign the number to your Voice API Application in the Telnyx portal (`,_jsx(_components.a,{href:`/documentation/inventory/phone-numbers/your-own-telephony/telnyx`,children:`Telnyx`}),`).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`InTalk`}),`: set the static WSS URL in InTalk’s portal (`,_jsx(_components.a,{href:`/documentation/inventory/phone-numbers/your-own-telephony/intalk`,children:`InTalk`}),`).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Other providers`}),`: set the routing in the provider’s console. Ozonetel’s URLs are on its `,_jsx(_components.a,{href:`/documentation/inventory/phone-numbers/your-own-telephony/ozonetel`,children:`guide`}),`; for the rest, contact Ringg.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Ringg-provided numbers need no setup.`}),`\n`,_jsx(Heading,{level:`3`,id:`verify-it-worked`,children:`Verify it worked`}),`\n`,_jsx(_components.p,{children:`Call the number from your phone.`}),`\n`,_jsx(Check,{children:_jsxs(_components.p,{children:[`The agent answers, and the call appears at the top of `,_jsx(_components.a,{href:`/documentation/monitor/logs`,children:`Logs`}),` with call type `,_jsx(_components.strong,{children:`Inbound`}),`. Any `,_jsx(_components.a,{href:`/documentation/build-agents/customize-agent-behaviour/event-subscription`,children:`Event Subscription`}),` you set up fires for it.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`outbound-choose-the-caller-id`,children:`Outbound: choose the caller ID`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`How you call`}),_jsx(_components.th,{children:`Where you pick the caller ID`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/documentation/build-agents/test-and-improve/test-an-agent`,children:`Test call`}),` from the agent editor`]}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Choose a number`}),` (“The number assistant will call from.”). It lists `,_jsx(_components.strong,{children:`Test numbers`}),`, `,_jsx(_components.strong,{children:`Your numbers`}),`, and `,_jsx(_components.strong,{children:`In use`}),` numbers (attached to an agent, shown but disabled).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/documentation/deploy/campaigns/create-a-campaign`,children:`Campaign`})}),_jsxs(_components.td,{children:[`The `,_jsx(_components.strong,{children:`Select number`}),` card: `,_jsx(_components.strong,{children:`Individual numbers`}),` (pick one or more; each shows its provider and a `,_jsx(_components.strong,{children:`Spam`}),` chip if flagged) or `,_jsx(_components.strong,{children:`Number pool`}),` to rotate across a `,_jsx(_components.a,{href:`/documentation/inventory/phone-numbers/number-pools`,children:`pool`}),`. Test numbers are not listed.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`API call`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`from_number_id`}),`, `,_jsx(_components.code,{children:`from_number`}),` or `,_jsx(_components.code,{children:`number_pool_id`}),` (below).`]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`caller-id-with-the-api`,children:`Caller ID with the API`}),`\n`,_jsxs(_components.p,{children:[`You need an `,_jsx(_components.a,{href:`/documentation/manage-account/api-key`,children:`API key`}),`, the agent’s ID (`,_jsx(_components.a,{href:`/documentation/build-agents/agents/agent-types#find-the-agent-id`,children:`Find an agent’s ID`}),`) and a caller number from your workspace (`,_jsx(_components.a,{href:`/documentation/inventory/phone-numbers/buy-or-import-a-number`,children:`Buy or import a number`}),`).`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/api-reference/calling/individual-calls/initiate-individual-call`,children:`Initiate Individual Call`}),` takes one of:`]}),`\n`,_jsx(ResponseField,{name:`from_number_id`,type:`string | string[]`,id:`param-from-number-id`,children:_jsxs(_components.p,{children:[`A workspace number ID (the `,_jsx(_components.strong,{children:`ID`}),` column, or `,_jsx(_components.code,{children:`id`}),` from `,_jsx(_components.a,{href:`/api-reference/inventory/numbers/get-workspace-numbers`,children:`Get Workspace Numbers`}),`), or an array of IDs.`]})}),`\n`,_jsx(ResponseField,{name:`from_number`,type:`string | string[]`,id:`param-from-number`,children:_jsxs(_components.p,{children:[`A caller number with country code, for example `,_jsx(_components.code,{children:`+919876500001`}),`, or an array of numbers.`]})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/api-reference/calling/individual-calls/initiate-individual-call-v2`,children:`Initiate Individual Call (Number Pool)`}),` also accepts `,_jsx(_components.code,{children:`number_pool_id`}),` (`,_jsx(_components.strong,{children:`Copy pool ID`}),` on `,_jsx(_components.a,{href:`/documentation/inventory/phone-numbers/number-pools#the-pool-list`,children:`the pool list`}),`). Send at least one of the three; with a pool, the pool is used and the other field is ignored.`]}),`\n`,_jsxs(_components.p,{children:[`When no pool is sent, default outbound numbers set on the agent version take precedence over `,_jsx(_components.code,{children:`from_number_id`}),` and `,_jsx(_components.code,{children:`from_number`}),`.`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`9`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://prod-api.ringg.ai/ca/api/v0/calling/outbound/individual\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-KEY: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$RINGG_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\": \"Priya Sharma\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"mobile_number\": \"+919876543210\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agent_id\": \"b1972188-038e-4605-916c-3926e9d7bde4\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"from_number_id\": \"5d7f9a2b-1c3e-4f6a-8b9c-0d1e2f3a4b5c\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`11`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` res`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://prod-api.ringg.ai/ca/api/v0/calling/outbound/individual\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"POST\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"X-API-KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` process`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`RINGG_API_KEY`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Content-Type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` name:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Priya Sharma\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` mobile_number:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"+919876543210\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agent_id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"b1972188-038e-4605-916c-3926e9d7bde4\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` from_number_id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"5d7f9a2b-1c3e-4f6a-8b9c-0d1e2f3a4b5c\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }),`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` res`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`());`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`15`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`15`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` os`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`res `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.post(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://prod-api.ringg.ai/ca/api/v0/calling/outbound/individual\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"X-API-KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: os.environ[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"RINGG_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Priya Sharma\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"mobile_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+919876543210\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agent_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"b1972188-038e-4605-916c-3926e9d7bde4\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"from_number_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5d7f9a2b-1c3e-4f6a-8b9c-0d1e2f3a4b5c\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(res.json())`})]}),`\n`]})})})]}),`\n`,_jsxs(_components.p,{children:[`For campaigns, `,_jsx(_components.a,{href:`/api-reference/calling/campaigns/start-campaign`,children:`Start Campaign`}),` takes `,_jsx(_components.code,{children:`from_numbers`}),` (an array of number IDs, or numbers written exactly as listed in your workspace; each retry dials from the next one) and `,_jsx(_components.a,{href:`/api-reference/calling/campaigns/start-campaign-v2`,children:`Start Campaign (Number Pool)`}),` takes `,_jsx(_components.code,{children:`number_pool_id`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`My inbound number doesn't reach the agent`,id:`my-inbound-number-doesnt-reach-the-agent`,children:[_jsx(_components.p,{children:`Check these in order:`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The number is attached.`}),` On the Numbers page, the `,_jsx(_components.strong,{children:`Used By`}),` column should show your agent. If it shows another agent, detach it there and attach it to the right one.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The agent takes inbound calls.`}),` An outbound agent has no `,_jsx(_components.strong,{children:`Attach Number`}),` panel (`,_jsx(_components.a,{href:`#inbound-attach-a-number`,children:`which agents do`}),`).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The provider routes the number to Ringg.`}),` For your own telephony, finish the `,_jsx(_components.a,{href:`#provider-side-routing`,children:`provider-side routing`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Look in Logs.`}),` If the call appears in `,_jsx(_components.a,{href:`/documentation/monitor/logs`,children:`Logs`}),`, it reached Ringg and the agent’s settings are the next place to look. If it doesn’t, the call never reached Ringg; check the number with your provider.`]}),`\n`]})]}),_jsx(Accordion,{title:`My number isn't in the Inbound Number list`,id:`my-number-isnt-in-the-inbound-number-list`,children:_jsxs(_components.p,{children:[`Check that `,_jsx(_components.strong,{children:`Telephony`}),` is set to the account the number belongs to, and that the number meets the `,_jsx(_components.a,{href:`#inbound-attach-a-number`,children:`three conditions`}),` above.`]})}),_jsx(Accordion,{title:`The test call says to use the IN or US test number`,id:`the-test-call-says-to-use-the-in-or-us-test-number`,children:_jsxs(_components.p,{children:[`Test numbers are region-bound. The Indian test number calls Indian numbers only; the US test number calls numbers outside India. Click `,_jsx(_components.strong,{children:`Switch`}),` or pick one of your own numbers. See `,_jsx(_components.a,{href:`/documentation/inventory/phone-numbers/overview#test-numbers`,children:`Test numbers`}),`.`]})}),_jsx(Accordion,{title:`The API returns an error about the caller number`,id:`the-api-returns-an-error-about-the-caller-number`,children:_jsxs(_components.p,{children:[`Send `,_jsx(_components.code,{children:`from_number_id`}),` or `,_jsx(_components.code,{children:`from_number`}),`, not both. Sending neither returns `,_jsx(_components.code,{children:`400`}),` unless the agent version has default outbound numbers. On `,_jsx(_components.a,{href:`/api-reference/calling/individual-calls/initiate-individual-call-v2`,children:`Initiate Individual Call (Number Pool)`}),`, both together or none of the three returns `,_jsx(_components.code,{children:`422`}),`.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`Run a campaign`,icon:`megaphone`,href:`/documentation/deploy/campaigns/create-a-campaign`,children:_jsx(_components.p,{children:`Call a contact list from your numbers.`})}),_jsx(Card,{title:`Read call logs`,icon:`list-checks`,href:`/documentation/monitor/logs`,children:_jsx(_components.p,{children:`Find the inbound call with its recording and transcript.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Inbound agent number","sidebarTitle":"Inbound agent number","description":"Attach a phone number to an inbound agent in the Ringg agent editor, and choose the caller ID for outbound calls and campaigns with from_number_id or a pool.","boost":4,"og:title":"Attach a number to an agent and set outbound caller ID","href":"/documentation/inventory/phone-numbers/inbound-agent-number"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Inbound: attach a number","slug":"inbound-attach-a-number","depth":2,"children":[{"title":"Detach a number","slug":"detach-a-number","depth":3,"children":[]},{"title":"Provider-side routing","slug":"provider-side-routing","depth":3,"children":[]},{"title":"Verify it worked","slug":"verify-it-worked","depth":3,"children":[]}]},{"title":"Outbound: choose the caller ID","slug":"outbound-choose-the-caller-id","depth":2,"children":[{"title":"Caller ID with the API","slug":"caller-id-with-the-api","depth":3,"children":[]}]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ringgai-0da73d20/45c33e65ef05fabf/hairline.js"],"dynamicCss":".mint-w-full {\n width: 100%\n}\n.mint-rounded-xl {\n border-radius: 0.75rem\n}","subdomain":"ringgai-0da73d20","siteName":"Ringg AI","title":"Attach a number to an agent and set outbound caller ID","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-13T11:53:22.479Z","originalFileLocation":"documentation/inventory/phone-numbers/inbound-agent-number.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Attach a phone number to an inbound agent in the Ringg agent editor, and choose the caller ID for outbound calls and campaigns with from_number_id or a pool.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ringg AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Attach a number to an agent and set outbound caller ID\">\u003cmeta data-mint-head property=\"og:description\" content=\"Attach a phone number to an inbound agent in the Ringg agent editor, and choose the caller ID for outbound calls and campaigns with from_number_id or a pool.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ringg AI Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ringg.ai/documentation/inventory/phone-numbers/inbound-agent-number\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ringgai-0da73d20.mintlify.site/_mintlify/api/og/v2?division=Phone+numbers\u0026amp;title=Inbound+agent+number\u0026amp;description=Attach+a+phone+number+to+an+inbound+agent+in+the+Ringg+agent+editor%2C+and+choose+the+caller+ID+for+outbound+calls+and+campaigns+with+from_number_id+or+a+pool.\u0026amp;theme=737b8671029ef070100737b1\u0026amp;signature=9af24569a4bc40ade832aca4121e0dbf555aed80175a44ba720bb30cf60c3142\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Attach a number to an agent and set outbound caller ID\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Attach a phone number to an inbound agent in the Ringg agent editor, and choose the caller ID for outbound calls and campaigns with from_number_id or a pool.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ringgai-0da73d20.mintlify.site/_mintlify/api/og/v2?division=Phone+numbers\u0026amp;title=Inbound+agent+number\u0026amp;description=Attach+a+phone+number+to+an+inbound+agent+in+the+Ringg+agent+editor%2C+and+choose+the+caller+ID+for+outbound+calls+and+campaigns+with+from_number_id+or+a+pool.\u0026amp;theme=737b8671029ef070100737b1\u0026amp;signature=9af24569a4bc40ade832aca4121e0dbf555aed80175a44ba720bb30cf60c3142\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ringg AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A0A0B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ringg.ai/documentation/inventory/phone-numbers/inbound-agent-number\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/documentation/inventory/phone-numbers/inbound-agent-number.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.ringg.ai/#organization\",\"name\":\"Ringg AI\",\"legalName\":\"Stoic AI Private Limited\",\"url\":\"https://www.ringg.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://assets.ringg.ai/images/logo/logo.svg\"},\"sameAs\":[\"https://x.com/ringg_ai\",\"https://www.linkedin.com/company/ringg\",\"https://www.youtube.com/@RinggAI\",\"https://www.instagram.com/ringg_ai\",\"https://discord.gg/YuEnb8Vsca\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ringg.ai#website\",\"name\":\"Ringg AI\",\"url\":\"https://docs.ringg.ai\",\"publisher\":{\"@id\":\"https://www.ringg.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ringg.ai/documentation/inventory/phone-numbers/inbound-agent-number#webpage\",\"url\":\"https://docs.ringg.ai/documentation/inventory/phone-numbers/inbound-agent-number\",\"name\":\"Inbound agent number\",\"description\":\"Attach a phone number to an inbound agent in the Ringg agent editor, and choose the caller ID for outbound calls and campaigns with from_number_id or a pool.\",\"dateModified\":\"2026-10-13T11:53:22.479Z\",\"isPartOf\":{\"@id\":\"https://docs.ringg.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ringg.ai/documentation/inventory/phone-numbers/inbound-agent-number#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ringg.ai/documentation/inventory/phone-numbers/inbound-agent-number#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Inventory\",\"item\":\"https://docs.ringg.ai/documentation/inventory/knowledge-base\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Phone numbers\",\"item\":\"https://docs.ringg.ai/documentation/inventory/phone-numbers/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Inbound agent number\",\"item\":\"https://docs.ringg.ai/documentation/inventory/phone-numbers/inbound-agent-number\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.ringg.ai/documentation/inventory/phone-numbers/inbound-agent-number#article\",\"headline\":\"Inbound agent number\",\"name\":\"Inbound agent number\",\"description\":\"Attach a phone number to an inbound agent in the Ringg agent editor, and choose the caller ID for outbound calls and campaigns with from_number_id or a pool.\",\"url\":\"https://docs.ringg.ai/documentation/inventory/phone-numbers/inbound-agent-number\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ringg.ai/documentation/inventory/phone-numbers/inbound-agent-number#webpage\"},\"dateModified\":\"2026-10-13T11:53:22.479Z\",\"publisher\":{\"@id\":\"https://www.ringg.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ringg.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ringg AI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ringg AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/documentation/inventory/phone-numbers/inbound-agent-number.md","siteName":"Ringg AI","nav":{"global":null,"tabs":[{"tab":"Get started","pages":[{"title":"Get started","href":"/get-started/introduction"}]},{"tab":"Documentation","pages":[{"title":"Ringg AI documentation","sidebarTitle":"Introduction","icon":"book-open","href":"/documentation/introduction"},{"group":"Build agents","icon":"bot","pages":[{"group":"Agents","pages":[{"title":"Agent types","sidebarTitle":"Agent types","href":"/documentation/build-agents/agents/agent-types"},{"title":"Create an agent","sidebarTitle":"Create an agent","href":"/documentation/build-agents/agents/create-an-agent"},{"group":"Multi-prompt agents","pages":[{"title":"Multi-prompt agents","sidebarTitle":"Overview","href":"/documentation/build-agents/agents/multi-prompt-agents/overview"},{"title":"Node types and connections","sidebarTitle":"Node types and connections","href":"/documentation/build-agents/agents/multi-prompt-agents/node-types-and-connections"},{"title":"Multi-prompt global settings","sidebarTitle":"Global settings","href":"/documentation/build-agents/agents/multi-prompt-agents/global-settings"},{"title":"Test and convert multi-prompt agents","sidebarTitle":"Test and convert","href":"/documentation/build-agents/agents/multi-prompt-agents/test-and-convert"}]},{"group":"WhatsApp agents","tag":"NEW","pages":[{"title":"WhatsApp agents","sidebarTitle":"Overview","href":"/documentation/build-agents/agents/whatsapp-agents/overview"},{"title":"Create a WhatsApp agent","sidebarTitle":"Create an agent","href":"/documentation/build-agents/agents/whatsapp-agents/create-an-agent"},{"title":"WhatsApp Flows","sidebarTitle":"Flows","href":"/documentation/build-agents/agents/whatsapp-agents/flows"},{"title":"Build WhatsApp Flows in Ringg","sidebarTitle":"Flow builder","href":"/documentation/build-agents/agents/whatsapp-agents/flow-builder"},{"title":"WhatsApp Flows with live data","sidebarTitle":"Flows with live data","href":"/documentation/build-agents/agents/whatsapp-agents/flows-live-data"},{"title":"Live data from your server","sidebarTitle":"Live data from your server","href":"/documentation/build-agents/agents/whatsapp-agents/flows-your-server"}]}]},{"group":"Customize agent behaviour","pages":[{"title":"Agent prompt","sidebarTitle":"Agent prompt","href":"/documentation/build-agents/customize-agent-behaviour/agent-prompt"},{"title":"Voice and language","sidebarTitle":"Voice and language","href":"/documentation/build-agents/customize-agent-behaviour/voice-and-language"},{"title":"Custom variables","sidebarTitle":"Custom variables","href":"/documentation/build-agents/customize-agent-behaviour/custom-variables"},{"title":"Attach a knowledge base","sidebarTitle":"Attach a knowledge base","href":"/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base"},{"group":"Tools","pages":[{"title":"Tools","sidebarTitle":"Overview","href":"/documentation/build-agents/customize-agent-behaviour/tools/overview"},{"title":"API tools","sidebarTitle":"API tools","href":"/documentation/build-agents/customize-agent-behaviour/tools/api-tools"},{"title":"Integration tools","sidebarTitle":"Integration tools","href":"/documentation/build-agents/customize-agent-behaviour/tools/integration-tools"},{"title":"System tools","sidebarTitle":"System tools","href":"/documentation/build-agents/customize-agent-behaviour/tools/system-tools"},{"title":"Function tools and conditions","sidebarTitle":"Function tools and conditions","href":"/documentation/build-agents/customize-agent-behaviour/tools/function-tools-and-conditions"},{"title":"Post-call tools","sidebarTitle":"Post-call tools","href":"/documentation/build-agents/customize-agent-behaviour/tools/post-call-tools"},{"title":"Workspace tools","sidebarTitle":"Workspace tools","href":"/documentation/build-agents/customize-agent-behaviour/tools/workspace-tools"},{"title":"WhatsApp tools","sidebarTitle":"WhatsApp tools","tag":"NEW","href":"/documentation/build-agents/customize-agent-behaviour/tools/whatsapp-tools"}]},{"title":"Call settings","sidebarTitle":"Call settings","href":"/documentation/build-agents/customize-agent-behaviour/call-settings"},{"title":"Advanced Analysis","sidebarTitle":"Advanced Analysis","href":"/documentation/build-agents/customize-agent-behaviour/advanced-analysis"},{"title":"Event Subscription","sidebarTitle":"Event Subscription","href":"/documentation/build-agents/customize-agent-behaviour/event-subscription"},{"group":"Webhooks","pages":[{"title":"Webhook setup and errors","sidebarTitle":"Setup and errors","href":"/documentation/build-agents/customize-agent-behaviour/webhooks/setup-and-errors"},{"title":"Call events","sidebarTitle":"Call events","href":"/documentation/build-agents/customize-agent-behaviour/webhooks/call-events"},{"title":"WhatsApp chat events","sidebarTitle":"WhatsApp chat events","tag":"NEW","href":"/documentation/build-agents/customize-agent-behaviour/webhooks/whatsapp-chat-events"},{"title":"Webhook field reference","sidebarTitle":"Field reference","href":"/documentation/build-agents/customize-agent-behaviour/webhooks/field-reference"}]}]},{"group":"Test and improve","pages":[{"title":"Test an agent","sidebarTitle":"Test an agent","href":"/documentation/build-agents/test-and-improve/test-an-agent"},{"title":"Drafts and versions","sidebarTitle":"Drafts and versions","href":"/documentation/build-agents/test-and-improve/drafts-and-versions"}]},{"group":"Workflows","pages":[{"title":"Workflows","sidebarTitle":"Overview","href":"/documentation/build-agents/workflows/overview"},{"title":"Build a workflow","sidebarTitle":"Build a workflow","href":"/documentation/build-agents/workflows/build-a-workflow"},{"title":"Test and publish a workflow","sidebarTitle":"Test and publish","href":"/documentation/build-agents/workflows/test-and-publish"},{"title":"Workflow block reference","sidebarTitle":"Block reference","href":"/documentation/build-agents/workflows/block-reference"}]}]},{"group":"Inventory","icon":"package","pages":[{"title":"Knowledge base","sidebarTitle":"Knowledge base","href":"/documentation/inventory/knowledge-base"},{"group":"Tools (integrations)","pages":[{"title":"Connect an app","sidebarTitle":"Connect an app","href":"/documentation/inventory/tools-integrations/connect-an-app"},{"title":"Connect WhatsApp","sidebarTitle":"Connect WhatsApp","tag":"NEW","href":"/documentation/inventory/tools-integrations/connect-whatsapp"}]},{"group":"Phone numbers","pages":[{"title":"Phone numbers","sidebarTitle":"Overview","href":"/documentation/inventory/phone-numbers/overview"},{"title":"Buy or import a number","sidebarTitle":"Buy or import a number","href":"/documentation/inventory/phone-numbers/buy-or-import-a-number"},{"group":"Your own telephony","pages":[{"title":"Bring your own telephony","sidebarTitle":"BYOT overview","href":"/documentation/inventory/phone-numbers/your-own-telephony/byot-overview"},{"title":"SIP trunking","sidebarTitle":"SIP trunking","href":"/documentation/inventory/phone-numbers/your-own-telephony/sip-trunking"},{"title":"Plivo","sidebarTitle":"Plivo","href":"/documentation/inventory/phone-numbers/your-own-telephony/plivo"},{"title":"Exotel","sidebarTitle":"Exotel","href":"/documentation/inventory/phone-numbers/your-own-telephony/exotel"},{"title":"Twilio","sidebarTitle":"Twilio","href":"/documentation/inventory/phone-numbers/your-own-telephony/twilio"},{"title":"Telnyx","sidebarTitle":"Telnyx","href":"/documentation/inventory/phone-numbers/your-own-telephony/telnyx"},{"title":"InTalk","sidebarTitle":"InTalk","href":"/documentation/inventory/phone-numbers/your-own-telephony/intalk"},{"title":"Ameyo","sidebarTitle":"Ameyo","href":"/documentation/inventory/phone-numbers/your-own-telephony/ameyo"},{"title":"Ozonetel","sidebarTitle":"Ozonetel","href":"/documentation/inventory/phone-numbers/your-own-telephony/ozonetel"},{"title":"New provider requirements","sidebarTitle":"New provider requirements","href":"/documentation/inventory/phone-numbers/your-own-telephony/new-provider-requirements"}]},{"title":"Number pools","sidebarTitle":"Number pools","description":"Create a number pool in Ringg to rotate outbound caller IDs, skip spam-flagged numbers and buy replacements, then use it in campaigns and v2 API calls.","href":"/documentation/inventory/phone-numbers/number-pools"},{"title":"Inbound agent number","sidebarTitle":"Inbound agent number","href":"/documentation/inventory/phone-numbers/inbound-agent-number"}]}]},{"group":"Deploy","icon":"rocket","pages":[{"group":"Campaigns","pages":[{"title":"Campaigns","sidebarTitle":"Overview","description":"Understand Ringg AI campaigns: an agent calls every contact in a CSV inside calling windows, with retries. See each status and how concurrency is shared.","href":"/documentation/deploy/campaigns/overview"},{"title":"Create a campaign","sidebarTitle":"Create a campaign","href":"/documentation/deploy/campaigns/create-a-campaign"},{"title":"Workflow campaign","sidebarTitle":"Workflow campaign","href":"/documentation/deploy/campaigns/workflow-campaign"},{"title":"Campaigns by API","sidebarTitle":"Campaigns by API","href":"/documentation/deploy/campaigns/campaigns-by-api"},{"title":"Calling list","sidebarTitle":"Calling list","href":"/documentation/deploy/campaigns/calling-list"},{"title":"Manage a campaign","sidebarTitle":"Manage a campaign","href":"/documentation/deploy/campaigns/manage-a-campaign"}]},{"group":"Web and apps","pages":[{"group":"Web widget","pages":[{"title":"Web widget","sidebarTitle":"Overview","href":"/documentation/deploy/web-and-apps/web-widget/overview"},{"title":"Web widget configuration","sidebarTitle":"Configuration","href":"/documentation/deploy/web-and-apps/web-widget/configuration"},{"title":"Web widget events","sidebarTitle":"Events","href":"/documentation/deploy/web-and-apps/web-widget/events"},{"title":"Chat mode","sidebarTitle":"Chat mode","href":"/documentation/deploy/web-and-apps/web-widget/chat-mode"},{"title":"Chat components","sidebarTitle":"Components","href":"/documentation/deploy/web-and-apps/web-widget/components"},{"title":"Chat component data","sidebarTitle":"Data","href":"/documentation/deploy/web-and-apps/web-widget/data"},{"title":"Chat component recipes","sidebarTitle":"Recipes","href":"/documentation/deploy/web-and-apps/web-widget/recipes"},{"title":"Web widget styling","sidebarTitle":"Styling","href":"/documentation/deploy/web-and-apps/web-widget/styling"},{"title":"Web widget launch checklist","sidebarTitle":"Launch checklist","href":"/documentation/deploy/web-and-apps/web-widget/launch-checklist"}]},{"group":"Mobile apps","pages":[{"title":"Mobile app install","sidebarTitle":"Install","href":"/documentation/deploy/web-and-apps/mobile-apps/install"},{"title":"Mobile widget configuration","sidebarTitle":"Configuration","href":"/documentation/deploy/web-and-apps/mobile-apps/configuration"},{"title":"Mobile widget events","sidebarTitle":"Events","href":"/documentation/deploy/web-and-apps/mobile-apps/events"}]}]},{"group":"WhatsApp","tag":"NEW","pages":[{"title":"Start a conversation","sidebarTitle":"Start a conversation","href":"/documentation/deploy/whatsapp/start-a-conversation"},{"title":"WhatsApp Relay","sidebarTitle":"Relay overview","href":"/documentation/deploy/whatsapp/relay-overview"},{"title":"WhatsApp Relay integration guide","sidebarTitle":"Relay integration guide","href":"/documentation/deploy/whatsapp/relay-integration-guide"},{"title":"WhatsApp Relay troubleshooting","sidebarTitle":"Relay troubleshooting","href":"/documentation/deploy/whatsapp/relay-troubleshooting"}]}]},{"group":"Monitor","icon":"chart-line","pages":[{"title":"Logs","sidebarTitle":"Logs","href":"/documentation/monitor/logs"},{"title":"Analytics","sidebarTitle":"Analytics","href":"/documentation/monitor/analytics"},{"title":"Evals","sidebarTitle":"Evals","href":"/documentation/monitor/evals"},{"title":"Alerts","sidebarTitle":"Alerts","href":"/documentation/monitor/alerts"}]},{"group":"Manage account","icon":"settings","pages":[{"title":"Members","sidebarTitle":"Members","href":"/documentation/manage-account/members"},{"title":"API key","sidebarTitle":"API key","href":"/documentation/manage-account/api-key"},{"title":"Billing","sidebarTitle":"Billing","href":"/documentation/manage-account/billing"},{"title":"Call limits","sidebarTitle":"Call limits","href":"/documentation/manage-account/call-limits"},{"group":"Ringg Spaces","pages":[{"title":"Ringg Spaces","sidebarTitle":"Overview","href":"/documentation/manage-account/ringg-spaces/overview"},{"title":"Create and manage Ringg Spaces","sidebarTitle":"Create and manage","href":"/documentation/manage-account/ringg-spaces/create-and-manage"},{"title":"Ringg Spaces by API","sidebarTitle":"Ringg Spaces by API","href":"/documentation/manage-account/ringg-spaces/ringg-spaces-by-api"}]}]},{"group":"Ringg Labs","icon":"flask-conical","pages":[{"group":"Parrot STT","pages":[{"title":"Parrot STT Python SDK","sidebarTitle":"Python SDK","href":"/documentation/ringg-labs/parrot-stt/python-sdk"},{"title":"Parrot STT on TrueFoundry","sidebarTitle":"TrueFoundry","href":"/documentation/ringg-labs/parrot-stt/truefoundry"}]}]}]},{"tab":"Analytics platform","pages":[{"title":"Analytics platform","href":"/analytics-platform/introduction"}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference/introduction/quickstart"}]},{"tab":"Resources","menu":[{"item":"MCP server","description":"Let Claude, ChatGPT or Cursor work in your workspace, or search these docs","pages":[{"title":"MCP server","href":"/resources/mcp-server/docs-mcp-server/mcp-for-ai-assistants"}]},{"item":"Learn","description":"Lessons that build a payment-reminder system end to end","pages":[{"title":"Learn","href":"/resources/learn/all-lessons"}]},{"item":"Security","description":"How Ringg protects your data, and what to do on your side","pages":[{"title":"Security","href":"/resources/security/security"}]},{"item":"Changelog","description":"New features, API changes and new guides","pages":[{"title":"Changelog","href":"/resources/changelog/changelog"}]}],"pages":[{"title":"Resources","href":"/resources/mcp-server/docs-mcp-server/mcp-for-ai-assistants"}]}]},"basePath":"","title":"Attach a number to an agent and set outbound caller ID","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-BXrZabKK.js","DynamicMarkdown-CtasenyM.js","zoom-image-lightbox-C5F0mVLH.js","lightbox-handle-r17bVUz3.js"]}