Troubleshooting | AgentPhone

Start with the exact account, resource ID, and error response. The API’s request ID helps support trace a failed action; do not repeatedly resend a message or call while its outcome is unknown.

Symptom	Check first	Next step
iMessage option does not work on a standard number	Number type and subscription	Buy and activate an iMessage line. Buying a standard SMS number does not enable iMessage.
Registration says approved but SMS is blocked	Exact number’s `outboundSms`, registration scope, and `X-Sub-Account-Id`	Follow approved-registration troubleshooting.
iMessage returns `429`	`error.code`, not just the HTTP status	Separate the daily quota, reply-required limit, and inactivity restriction.
New conversations are paused	Safety code and recent engagement	Stop new outreach. Existing replies may continue. Contact support if review is needed.
API accepts a text but it never arrives	Original message in number/conversation history	Inspect `status` and `failureReason`. Acceptance is not delivery; see delivery failures.
Incoming text produces no response	Number attachment, selected webhook, and delivery log	Hosted voice prompts do not reply to texts. Your app must call the messaging API.
Webhook returns `401`	Saved signing secret and raw body	Use the signature verifier; do not re-serialize JSON before verification.
Voice caller hears silence	Voice mode, current transcript, and HTTP response	Return speech for a voice turn and inspect voice troubleshooting.
Calls fail with `402`, `409`, or `429`	Funding, number readiness, and active calls	Follow outbound calling requirements.
Balance is low despite auto-recharge being on	Paused recharge and failed payment attempts	Update the payment method and resume funding.
SIP creation returns `403`	SIP access in the selected account	Request access from the SIP trunking tab; see SIP trunking.
Resources appear missing	Parent versus sub-account selection	Use the same account scope for creation, lookup, registration, and sending.

What to send support

Email founders@agentphone.to with:

What you expected and what happened, with the time and timezone.
The endpoint, HTTP status, error.code or detail, and X-Request-Id/request_id.
The relevant agent, number, conversation, message, call, or delivery ID.
Whether you are using a sub-account, and a minimal request with credentials and personal message content removed.

For API feedback you can also submit feedback. Do not include API keys, signing secrets, payment card information, or recording/media bearer URLs in public issues.