# Bird Documentation > Published English documentation grouped by section and product, linked to its Markdown twins. ## Get started - [AI onboarding](https://bird.com/docs/get-started/ai-onboarding.md): Point your IDE or coding agent at Bird: paste one setup prompt to install the bird CLI and skills, connect the MCP server, or load the docs corpus. - [CLI](https://bird.com/docs/get-started/quickstarts/cli/email.md): Send your first email from the terminal with the bird CLI: log in once with send permission, then send and check a message with two commands. - [Claim your first agent mailbox](https://bird.com/docs/get-started/agent-mailboxes.md): Create a mailbox on inbox.ai, receive mail into a thread, and reply through the API to complete an agent's two-way email loop. - [Get started with Bird](https://bird.com/docs.md): Email, SMS, and WhatsApp on one platform. Pick a use-case quickstart and go from zero to your first successful send. - [Go · Gin](https://bird.com/docs/get-started/quickstarts/go/gin/email.md): Send your first email from a Gin application with the Bird Go SDK: install the module, add a POST route that sends, and run it with curl. - [Go](https://bird.com/docs/get-started/quickstarts/go/email.md): Send your first email from Go with the Bird Go SDK: install the module, write a net/http handler that sends, and run it with curl. - [PHP](https://bird.com/docs/get-started/quickstarts/php/email.md): Send your first email from a plain PHP script with the Bird PHP SDK: install messagebird/sdk, call email->send, and run it. - [Preview your first automation](https://bird.com/docs/get-started/automations.md): Explore an SMS notification workflow in the Bird dashboard and inspect a sample message without publishing or sending it. - [Preview your first voice sequence](https://bird.com/docs/get-started/voice-sequences.md): Explore a voice menu in the Bird dashboard, follow sample keypad choices, and create an editable draft without placing a real call. - [Python · Django](https://bird.com/docs/get-started/quickstarts/python/django/email.md): Send your first email from a Django view with the Bird Python SDK: install messagebird-sdk, add a view and URL, and try it with curl. - [Python · FastAPI](https://bird.com/docs/get-started/quickstarts/python/fastapi/email.md): Send your first email from an async FastAPI endpoint with the Bird Python SDK: install, add a route using AsyncBird, and try it with curl. - [Python · Flask](https://bird.com/docs/get-started/quickstarts/python/flask/email.md): Send your first email from a Flask route with the Bird Python SDK: install messagebird-sdk, add a POST route, and try it with curl. - [Python](https://bird.com/docs/get-started/quickstarts/python/email.md): Send your first email from a plain Python script with the Bird Python SDK: install messagebird-sdk, call email.send, and run it. - [Quickstarts](https://bird.com/docs/get-started/quickstarts.md): Pick your language or framework and follow one direct path from a Bird API key to an accepted email with a deterministic sandbox outcome. - [Reply to your first Apple Messages conversation](https://bird.com/docs/get-started/apple-messages.md): Start a test Apple Messages conversation, find it in the Bird dashboard, send a text reply, and check the recorded message outcome. - [Send your first SMS](https://bird.com/docs/get-started/send-your-first-sms.md): Create a Bird API key, enable a destination country, send a built-in template SMS to your phone, and read back its delivery status. - [Send your first email](https://bird.com/docs/get-started/send-your-first-email.md): Create a Bird API key, send a sandbox email without verifying a domain, and check the message's delivery status through the API. - [Send your first realtime event](https://bird.com/docs/get-started/send-your-first-realtime-event.md): Create a Realtime app, subscribe a web, iOS, or Android client to a channel, and publish a server event that the client receives over WebSockets. - [TypeScript / Node.js](https://bird.com/docs/get-started/quickstarts/typescript/email.md): Send your first email from a plain Node.js script with the Bird TypeScript SDK: install @messagebird/sdk, call email.send, and run it. - [TypeScript · Astro](https://bird.com/docs/get-started/quickstarts/typescript/astro/email.md): Send your first email from an Astro API route with the Bird TypeScript SDK: install, add an on-demand route that sends, and try it. - [TypeScript · Bun](https://bird.com/docs/get-started/quickstarts/typescript/bun/email.md): Send your first email from a Bun.serve fetch handler with the Bird TypeScript SDK. Bun runs the TypeScript directly, with no build step. - [TypeScript · Express](https://bird.com/docs/get-started/quickstarts/typescript/express/email.md): Send your first email from an Express 5 route with the Bird TypeScript SDK: install both packages, add a POST route, and try it with curl. - [TypeScript · Hono](https://bird.com/docs/get-started/quickstarts/typescript/hono/email.md): Send your first email from a Hono POST handler on Node.js with the Bird TypeScript SDK: create an app, add the route, and try it with curl. - [TypeScript · Next.js](https://bird.com/docs/get-started/quickstarts/typescript/next-js/email.md): Send your first email from a Next.js Server Action with the Bird TypeScript SDK: install, add an action, and trigger it from a form. - [TypeScript · Nuxt](https://bird.com/docs/get-started/quickstarts/typescript/nuxt/email.md): Send your first email from a Nuxt server route with the Bird TypeScript SDK: install, add a Nitro event handler, and POST to it. - [TypeScript · Remix](https://bird.com/docs/get-started/quickstarts/typescript/remix/email.md): Send your first email from a Remix resource route with the Bird TypeScript SDK: install, add an action that sends, and POST to it. - [TypeScript · SvelteKit](https://bird.com/docs/get-started/quickstarts/typescript/sveltekit/email.md): Send your first email from a SvelteKit server endpoint with the Bird TypeScript SDK: install, add a +server.ts POST handler, and try it. - [Verify your first customer](https://bird.com/docs/get-started/verify-your-first-customer.md): Send a one-time passcode with Bird Verify and confirm it, from an API key to a verified user in two calls, with no sender to register. - [cURL](https://bird.com/docs/get-started/quickstarts/curl/email.md): Send your first email with nothing but curl: export a key, POST to the Bird email API, and GET the message back to watch it deliver. ## AI - [AI builder guides](https://bird.com/docs/ai/ai-builder-guides.md): Patterns for building agents and apps on Bird: the agent loop, async send outcomes, sandbox testing, error recovery, and safe retries. - [Agent skills](https://bird.com/docs/ai/agent-skills.md): Prebuilt skill files that teach a coding agent the bird CLI workflows, with one reference per command group across every channel Bird runs. - [CLI for agents](https://bird.com/docs/ai/cli-for-agents.md): The bird CLI's agent contract, with JSON output by default, errors on stderr, branchable exit codes, and safe retries. - [Connect an AI voice application](https://bird.com/docs/ai/voice-conversations.md): Connect a conversational AI runtime to Bird Voice over SIP, prepare incoming and outgoing calls, and test business actions and human handoff. - [MCP Events](https://bird.com/docs/ai/mcp-events.md): Subscribe your MCP client to Bird events, such as a new email in a mailbox or an inbound SMS, and receive each one as a signed webhook on mcp.bird.com. - [MCP server](https://bird.com/docs/ai/mcp-server.md): Connect any MCP client to Bird's hosted server at mcp.bird.com with a URL and a browser sign-in, or run it locally over stdio with the bird CLI. - [Query email analytics with AI](https://bird.com/docs/ai/email-analytics.md): Ask an AI assistant about email delivery, engagement, and latency through Bird MCP, with example prompts and guidance for interpreting results. - [Route messages to your AI agent](https://bird.com/docs/ai/route-messages-to-an-agent.md): Send each WhatsApp, SMS, Apple Messages or email message you receive to Claude or Grok Bot. Set it up from the dashboard, CLI or API. - [Self-serve signup](https://bird.com/docs/ai/self-serve-signup.md): Create a Bird account, organization, workspace, and access token with curl or the CLI by verifying an email code, then connect local MCP. - [Set up your coding agent](https://bird.com/docs/ai/set-up-your-agent.md): Connect your coding agent to Bird through the CLI or MCP, confirm its workspace, and complete a first task for the product you are building. - [llms.txt and Markdown docs](https://bird.com/docs/ai/llms-txt.md): Find Bird documentation through llms.txt, public docs search, English guide exports and per-page Markdown, with the API contract available separately. ## Platform guides - [Abuse and compliance](https://bird.com/docs/guides/abuse-and-compliance.md): How Bird monitors abuse across channels, which controls affect requests directly, and how policy enforcement differs from health classifications. - [Authentication & API keys](https://bird.com/docs/guides/authentication.md): How Bird API requests authenticate with bearer keys: key anatomy, scopes and levels, expiry, rotation, revocation, and the OAuth path for the CLI and MCP. - [Billing & usage](https://bird.com/docs/guides/billing-and-usage.md): How Bird billing works for developers: plans and tiers, usage metering against your included volume, the shared wallet, invoices, and operational limits. - [Deliverability](https://bird.com/docs/guides/deliverability.md): Why sender reputation decides whether your messages reach recipients, what shapes it across every channel, and which inputs you control on Bird. - [Errors](https://bird.com/docs/guides/errors.md): The Bird error envelope: stable error codes, coarse types, field-level validation details, recovery guidance, and how to branch on failures. - [Guides](https://bird.com/docs/guides.md): Task-oriented guides for building on Bird: platform concepts, API mechanics, deliverability, and a deep dive into each messaging channel. - [Idempotency](https://bird.com/docs/guides/idempotency.md): Safe retries with the Idempotency-Key header: replay semantics, key scoping, conflict errors, and what happens when a request fails midway. - [Rate limits](https://bird.com/docs/guides/rate-limits.md): Pace requests with organization-wide rate-limit policies, check your effective plan limits, and handle HTTP 429 and SMTP retry responses. - [Users, teams & roles](https://bird.com/docs/guides/users-teams-roles.md): How people get access in Bird: workspace roles and what each can do, the org roles that manage billing, managing the team, and smart invitations. - [Webhooks & events](https://bird.com/docs/guides/webhooks.md): Receive Bird events as signed HTTPS deliveries: endpoint setup, Standard Webhooks signature verification, retries, replay, and the event envelope. - [Workspace](https://bird.com/docs/guides/workspaces.md): Understand workspace scope, regional routing, API key context, team access, and the account-closing lifecycle. ## Email guides - [Abuse & compliance · Email](https://bird.com/docs/guides/email/abuse-and-compliance.md): Understand email health classifications, investigate bounce and complaint risk, and use suppressions, list hygiene, and consent to protect delivery. - [Agent mailboxes](https://bird.com/docs/guides/email/mailboxes.md): Durable, programmable inboxes on inbox.ai. Receive mail into threads, filter it, reply, and send, all over the API. - [Attachments](https://bird.com/docs/guides/email/attachments.md): Attach files and inline images to email messages, follow size and encoding limits, and download stored attachments through the API. - [Audiences](https://bird.com/docs/guides/email/audiences.md): Group contacts into reusable audiences, add or remove members, and send to a saved list instead of assembling the same addresses every time. - [BIMI](https://bird.com/docs/guides/email/bimi.md): Publish a BIMI record so supporting mailbox providers can display your verified brand logo with authenticated email messages. - [Batch sending](https://bird.com/docs/guides/email/sending-bulk.md): Send up to 100 independent emails in one request with POST /v1/email/batches, validated all-or-nothing and safe to retry with an idempotency key. - [Bounce domain](https://bird.com/docs/guides/email/bounce-domain.md): The return-path (bounce) hostname on your sending domain, what it does, how to customize it, and why it gives you SPF alignment without an apex record. - [Broadcasts](https://bird.com/docs/guides/email/broadcasts.md): Send one email to a stored audience from the dashboard, the API, or the bird CLI, then schedule it, follow its delivery, and fix a broadcast that failed. - [Categories](https://bird.com/docs/guides/email/categories.md): How the marketing and transactional categories classify your email and drive suppression policy, and why transactional sends must set the category explicitly. - [Check email templates in CI](https://bird.com/docs/guides/email/ci-checks.md): Fail a pull request before a template ships broken: check every language for mail-client support, Gmail's size limit, and broken links and images. - [Competitive Insights](https://bird.com/docs/guides/email/competitive-insights.md): Watch competitor brands' email programs and compare their send volume, cadence, inbox placement, and campaigns against your own sending. - [Contacts](https://bird.com/docs/guides/email/contacts.md): Store customer identifiers and typed custom properties, import contacts in bulk, and keep them in sync with your own records. - [DKIM, SPF & DMARC](https://bird.com/docs/guides/email/dkim-spf-dmarc.md): What each DNS record on a sending domain proves, the exact record shapes, why apex SPF is not required, and where verification is covered. - [Dedicated IPs and pools](https://bird.com/docs/guides/email/dedicated-ips-and-pools.md): Buy dedicated IPs, group them into pools, and route each send with ip_pool_id, with the shared pool as the default and safety rules that protect delivery. - [Deliverability · Email](https://bird.com/docs/guides/email/deliverability.md): How the shared reputation model applies to email: domain authentication, dedicated IPs and warmup, and reputation monitoring, with links to each. - [Email events](https://bird.com/docs/guides/email/events.md): The catalog of email events we emit: lifecycle, failure, engagement, and message-level, with per-event payload fields and bounce classification. - [Email log](https://bird.com/docs/guides/email/email-log.md): Browse, filter, and inspect every message your workspace sent from the Emails page: statuses, the per-recipient event timeline, and the rendered preview. - [Email metrics](https://bird.com/docs/guides/email/tracking-and-metrics.md): What each number on the email Metrics dashboard means, the healthy ranges, and what to do when a rate drifts into risk. - [Email overview](https://bird.com/docs/guides/email/overview.md): Understand how Bird sends and receives email, how delivery progresses after acceptance, and where to configure Email in the dashboard. - [Email stats API](https://bird.com/docs/guides/email/stats-api.md): Pull the aggregates behind the Metrics dashboard from the email stats API, including summary, daily and hourly series, 13 breakdowns, and the sending-health verdict. - [Email templates](https://bird.com/docs/guides/email/templates.md): How email templates work: an editable draft, published versions that never change, personalizing with Liquid, and sending by ID or slug. - [IP warmup](https://bird.com/docs/guides/email/ip-warmup.md): How we warm new dedicated IPs automatically over roughly 30 days, how to monitor warmup progress, and when to make a dedicated pool your default. - [Inbox Insights](https://bird.com/docs/guides/email/inbox-insights.md): Measure where your mail actually lands with per-provider inbox placement from seed accounts, and run seed tests against your own sends. - [Migrate from Amazon SES](https://bird.com/docs/guides/email/migrate/ses.md): Map the SES SendEmail v2 call to our send endpoint, export the account-level suppression list, and replace SNS event plumbing with signed webhooks. - [Migrate from Brevo](https://bird.com/docs/guides/email/migrate/brevo.md): Map the Brevo transactional email payload to our send endpoint, export both of its blocklists, and translate webhook event names to our event vocabulary. - [Migrate from MailerSend](https://bird.com/docs/guides/email/migrate/mailersend.md): Map the MailerSend email payload to our send endpoint, export the four permanent suppression lists without the temporary one, and translate activity events to our event vocabulary. - [Migrate from Mailgun](https://bird.com/docs/guides/email/migrate/mailgun.md): Map Mailgun's messages API parameters to our send endpoint, export bounces, complaints, and unsubscribes, and translate Mailgun event names to ours. - [Migrate from Mailjet](https://bird.com/docs/guides/email/migrate/mailjet.md): Map Mailjet's Send API v3.1 payload to our flat send endpoint, carry over your blocklist, and translate Mailjet's event types to our webhooks. - [Migrate from Mandrill](https://bird.com/docs/guides/email/migrate/mandrill.md): Map Mandrill's messages/send payload to our send endpoint, carry over your rejection blacklist, and translate Mandrill's webhook events to ours. - [Migrate from Postmark](https://bird.com/docs/guides/email/migrate/postmark.md): Map the Postmark email API payload to our send endpoint, dump your suppressions per message stream, and translate webhook record types to our event vocabulary. - [Migrate from Resend](https://bird.com/docs/guides/email/migrate/resend.md): Map Resend's send payload to our near-identical send endpoint, carry over suppressed addresses, and move from Svix-signed webhooks to Standard Webhooks. - [Migrate from SendGrid](https://bird.com/docs/guides/email/migrate/sendgrid.md): Map the SendGrid v3 Mail Send payload to our send endpoint, export your suppression lists, and translate Event Webhook names to our event vocabulary. - [Migrate from SparkPost](https://bird.com/docs/guides/email/migrate/sparkpost.md): Move your SparkPost email integration to Bird with mappings for transmissions, SMTP, templates, suppressions, and webhooks, plus a cutover checklist. - [Migrate from another provider](https://bird.com/docs/guides/email/migrate.md): Move your email sending here: map the send call, re-point DNS, import suppressions, switch webhooks, and verify in the sandbox before cutover. - [Open and click tracking](https://bird.com/docs/guides/email/open-click-tracking.md): How open and click tracking instrument each send, the pixel, rewritten links, the branded tracking hostname, and the per-send flags. - [Receiving email](https://bird.com/docs/guides/email/receiving-email.md): Receive email with a no-DNS forwarding address or MX records on your own domain, then read it in the dashboard, the API, or a webhook. - [Scheduled sending](https://bird.com/docs/guides/email/scheduled-sending.md): Schedule an email with scheduled_at, then choose the send time, list or cancel what's scheduled, and see what gets checked again right before it sends. - [Send email over SMTP](https://bird.com/docs/guides/email/smtp.md): Point any SMTP client at our servers and authenticate with an API key: connection settings, TLS, and the per-key defaults that shape each send. - [Sending domains](https://bird.com/docs/guides/email/sending-domains.md): Register a sending domain, publish its DNS records, and understand the verification lifecycle that gates live email sending. - [Sending email](https://bird.com/docs/guides/email/sending-email.md): Send one email with POST /v1/email/messages, personalize it with a template, tell tags apart from metadata, and see what the 202 response means. - [Suppressions](https://bird.com/docs/guides/email/suppressions.md): Learn how the workspace suppression list protects your sender reputation and how to manage suppressed recipients in the dashboard, API, or CLI. - [Synchronize audience membership](https://bird.com/docs/guides/email/synchronize-audience-membership.md): Turn a source-system cohort into explicit Bird audience membership, reconcile additions and removals, and recover an interrupted refresh. - [Test email delivery (mail sandbox)](https://bird.com/docs/guides/email/testing-sandbox.md): Trigger deterministic delivery outcomes (bounces, complaints, suppressions, rejections) through the real event and webhook pipeline, without a real inbox. - [Tracking domain](https://bird.com/docs/guides/email/tracking-domain.md): The branded CNAME that serves your open and click tracking, how to customize it, how it verifies, and how it relates to your per-send tracking flags. - [Unsubscribe links](https://bird.com/docs/guides/email/unsubscribe-links.md): The two ways a recipient opts out of your marketing mail: the one-click unsubscribe button, the in-body link, and the preference that stops the next send. ## SMS guides - [10DLC registration](https://bird.com/docs/guides/sms/10dlc.md): Why US A2P messaging needs a registered brand and campaign, how the brand-campaign-number model fits together, and what a workspace prepares. - [Migrate SMS from Bandwidth](https://bird.com/docs/guides/sms/migrate/bandwidth.md): Map Bandwidth's Messages API to Bird's SMS send endpoint, move opt-out state your own application holds, and translate callbacks to events. - [Migrate SMS from Bird Connectivity Platform](https://bird.com/docs/guides/sms/migrate/connectivity-platform.md): Map the Connectivity Platform Messages API to Bird's SMS endpoint, move originators and opt-outs, and replace reportUrl reports with signed webhooks. - [Migrate SMS from Infobip](https://bird.com/docs/guides/sms/migrate/infobip.md): Flatten Infobip's nested send onto Bird's SMS endpoint, move a Blocklist to suppression pairs, and repoint your personalised base URL at a regional host. - [Migrate SMS from Plivo](https://bird.com/docs/guides/sms/migrate/plivo.md): Map Plivo's Message API to Bird's SMS send endpoint, move Powerpack senders and DND opt-outs, and translate message_state to events. - [Migrate SMS from Sinch](https://bird.com/docs/guides/sms/migrate/sinch.md): Map Sinch's batch send to Bird's SMS endpoint, rebuild opt-out state held as group membership, and translate delivery reports to events. - [Migrate SMS from Telnyx](https://bird.com/docs/guides/sms/migrate/telnyx.md): Map Telnyx's Messages API to Bird's SMS send endpoint, unpick messaging profiles, and translate delivery webhooks to events. - [Migrate SMS from Twilio](https://bird.com/docs/guides/sms/migrate/twilio.md): Map Twilio's Messages API to Bird's SMS send endpoint, move Messaging Service senders and opt-outs, and translate StatusCallback statuses to events. - [Migrate SMS from another provider](https://bird.com/docs/guides/sms/migrate.md): Move production SMS to Bird: enable destinations, set up a sender, map the send call, carry over opt-outs, switch webhooks, and test before cutover. - [Opt-outs and keywords](https://bird.com/docs/guides/sms/opt-outs-and-keywords.md): How Bird answers STOP, START, and HELP on your numbers, how an opt-out stops your sends, and how to change the replies or add campaign keywords of your own. - [Opt-outs](https://bird.com/docs/guides/sms/opt-outs.md): Configure SMS keyword rules, understand sender-and-subscriber suppressions, and manage opt-outs through Bird's canonical reference guide. - [SMS character limits and segment counting](https://bird.com/docs/guides/sms/character-limits.md): How SMS encoding and segment splitting work: GSM-7 and UCS-2 character limits, extension characters that cost two slots, emoji sizing, and the 12-segment cap. - [SMS delivery errors](https://bird.com/docs/guides/sms/delivery-errors.md): Look up SMS failure reasons and numeric provider codes, including fraud protection blocks, in message details, delivery receipts, and webhooks. - [SMS events](https://bird.com/docs/guides/sms/events.md): The SMS webhook event catalog: the delivery lifecycle, each event type's payload fields, and how to consume delivery events from your own systems. - [SMS log](https://bird.com/docs/guides/sms/sms-log.md): Browse, filter, and inspect SMS sent or received by your workspace: statuses, each message's event timeline, and segment and cost details. - [SMS metrics](https://bird.com/docs/guides/sms/tracking-and-metrics.md): How to read your aggregate SMS metrics in the Bird dashboard: delivery rate, failure rate, accepted volume, and delivery latency. - [SMS overview](https://bird.com/docs/guides/sms/overview.md): What Bird SMS is and how sending works: free-form text and template sends, the async delivery model, and where each page in this section fits. - [SMS sender IDs](https://bird.com/docs/guides/sms/senders.md): Choose an alphanumeric sender ID, long code, toll-free number, or short code, then meet each destination's registration and sender ID policy. - [SMS smart encoding](https://bird.com/docs/guides/sms/smart-encoding.md): Replace look-alike characters that force an SMS into UCS-2 with their GSM-7 equivalents: what smart encoding replaces, when it declines, and the full table. - [SMS stats API](https://bird.com/docs/guides/sms/stats-api.md): Pull the SMS Metrics dashboard aggregates from code, including summaries, time series, outbound breakdowns, and received-message counts. - [SMS templates](https://bird.com/docs/guides/sms/templates.md): Browse the SMS template catalog in the dashboard, read a template's category, languages, and variables, and send by template reference instead of free text. - [Sending SMS](https://bird.com/docs/guides/sms/sending-sms.md): Send a text message with POST /v1/sms/messages: recipient and sender formats, the segment cap, categories, destination settings, batch sends, and safe retries. ## WhatsApp guides - [Authoring WhatsApp templates](https://bird.com/docs/guides/whatsapp/authoring-templates.md): Create a WhatsApp template, write each language, preview variables, submit it for review and confirm the approved version before sending. - [Build a focused WhatsApp Flow](https://bird.com/docs/guides/whatsapp/native-flows.md): Design a native WhatsApp form, validate customer choices and connect the submitted result to your booking, order or service system. - [Business-scoped user IDs](https://bird.com/docs/guides/whatsapp/business-scoped-user-ids.md): Send WhatsApp messages using business-scoped user IDs (BSUIDs). Request a user's phone number and find their messages. - [Connect a WhatsApp commerce journey](https://bird.com/docs/guides/whatsapp/commerce.md): Connect WhatsApp product discovery to accurate stock, checkout and confirmed orders, with useful customer support throughout the journey. - [Connect click-to-WhatsApp ads to business outcomes](https://bird.com/docs/guides/whatsapp/click-to-whatsapp-attribution.md): Connect click-to-WhatsApp ads to useful conversations, preserve supported source details and measure confirmed leads, bookings or orders. - [Connect your WhatsApp Business app number](https://bird.com/docs/guides/whatsapp/coexistence/connect.md): Connect your WhatsApp Business app number to Bird with coexistence. Follow the QR code setup to keep using the app alongside Bird. - [Connect your WhatsApp number](https://bird.com/docs/guides/whatsapp/numbers/connect.md): Connect a pre-verified WhatsApp number to Bird. Follow each screen in Meta's signup, from choosing your number to creating a business account. - [Default WhatsApp numbers](https://bird.com/docs/guides/whatsapp/numbers/default.md): Send supported WhatsApp templates with Bird Verify, Bird Notify, or Authifly. Learn which number is used and when to connect your own number. - [Design a WhatsApp calling journey](https://bird.com/docs/guides/whatsapp/calling.md): Plan WhatsApp calling with sender eligibility, recipient permission, supported voice routing, customer context and useful follow-up. - [Launch a useful WhatsApp campaign](https://bird.com/docs/guides/whatsapp/marketing-campaigns.md): Prepare a WhatsApp campaign with a consented audience, approved template, response handling and a measurable customer outcome. - [Managing WhatsApp groups](https://bird.com/docs/guides/whatsapp/groups/management.md): Create a WhatsApp group over the API, wait for WhatsApp to confirm it, hand out its invite link, decide join requests, and pin, rename, or delete it. - [Mark message as read](https://bird.com/docs/guides/whatsapp/mark-message-as-read.md): Mark a received WhatsApp message as read, optionally show a typing indicator, and check when the acknowledgement has been processed. - [Meta business agent for WhatsApp](https://bird.com/docs/guides/whatsapp/meta-business-agent.md): Set up Meta Business Agent in Bird, add business knowledge and instructions, test replies, and introduce the agent to your WhatsApp customers. - [Plan a WhatsApp migration from 360dialog to Bird](https://bird.com/docs/guides/whatsapp/migrate-from-360dialog.md): Inventory the 360dialog integration, prepare the supported sender transition and verify the complete WhatsApp journey in Bird. - [Plan a WhatsApp migration from Infobip to Bird](https://bird.com/docs/guides/whatsapp/migrate-from-infobip.md): Inventory the Infobip integration, prepare the supported sender transition and verify the complete WhatsApp journey in Bird. - [Plan a WhatsApp migration from Twilio to Bird](https://bird.com/docs/guides/whatsapp/migrate-from-twilio.md): Inventory the Twilio integration, prepare the supported sender transition and verify the complete WhatsApp journey in Bird. - [Plan a WhatsApp migration from Wati to Bird](https://bird.com/docs/guides/whatsapp/migrate-from-wati.md): Inventory the Wati integration, prepare the supported sender transition and verify the complete WhatsApp journey in Bird. - [Prepare a WhatsApp AI agent and handoff](https://bird.com/docs/guides/whatsapp/ai-agents.md): Prepare a WhatsApp customer agent with trusted knowledge, authorized actions, scenario evaluation and a clear handoff to your team. - [Receiving WhatsApp audio](https://bird.com/docs/guides/whatsapp/receiving-whatsapp/audio.md): Read an inbound WhatsApp audio message, tell a recorded voice note from an attached file, and fetch the audio a contact sent you. - [Receiving WhatsApp contact cards](https://bird.com/docs/guides/whatsapp/receiving-whatsapp/contact-cards.md): Read a contact card a WhatsApp contact shared or a phone number they disclosed by tapping your request, and tell the two apart with origin. - [Receiving WhatsApp documents](https://bird.com/docs/guides/whatsapp/receiving-whatsapp/documents.md): Read an inbound WhatsApp document, its filename and caption, and fetch the file a contact sent you without trusting the name they gave it. - [Receiving WhatsApp group messages](https://bird.com/docs/guides/whatsapp/groups/receiving.md): How a group message reads back, which participant wrote it, how to reply to the group, and what the whatsapp.received webhook carries for one. - [Receiving WhatsApp images](https://bird.com/docs/guides/whatsapp/receiving-whatsapp/images.md): Read an inbound WhatsApp image, its stored media reference and caption, and fetch the bytes a contact sent you with your API key. - [Receiving WhatsApp interactive replies](https://bird.com/docs/guides/whatsapp/receiving-whatsapp/interactive-replies.md): Read what a WhatsApp contact tapped: a reply button, a list row, or a template quick reply, and the two taps that answer on other arms. - [Receiving WhatsApp locations](https://bird.com/docs/guides/whatsapp/receiving-whatsapp/location.md): Read an inbound WhatsApp location, the place name and address it sometimes carries, and the pin that answers a location request you sent. - [Receiving WhatsApp messages](https://bird.com/docs/guides/whatsapp/receiving-whatsapp.md): Read inbound WhatsApp messages over the API or the dashboard, fetch the media a contact sent, and subscribe to the whatsapp.received webhook event. - [Receiving WhatsApp stickers](https://bird.com/docs/guides/whatsapp/receiving-whatsapp/stickers.md): Read an inbound WhatsApp sticker, tell an animated one from a static one, and fetch the WebP file a contact sent you. - [Receiving WhatsApp text messages](https://bird.com/docs/guides/whatsapp/receiving-whatsapp/plain-text.md): Read the text a WhatsApp contact typed, on the API and on the whatsapp.received webhook, including a message they sent as a quoted reply. - [Receiving WhatsApp video](https://bird.com/docs/guides/whatsapp/receiving-whatsapp/video.md): Read an inbound WhatsApp video message, its stored media reference and caption, and fetch the clip a contact sent before it expires. - [Resolve a WhatsApp customer-service request](https://bird.com/docs/guides/whatsapp/service-conversations.md): Resolve a WhatsApp service request with verified identity, reply context, service-window checks, team assignment and a confirmed result. - [Sending WhatsApp messages](https://bird.com/docs/guides/whatsapp/sending-whatsapp.md): Send a WhatsApp template or service message with POST /v1/whatsapp/messages: the request envelope, the customer service window, the async 202 model, and cost. - [Sending WhatsApp reactions](https://bird.com/docs/guides/whatsapp/reactions.md): Add, replace, or remove an emoji reaction on a received WhatsApp message, then check its current state and reaction history. - [Sending to a WhatsApp group](https://bird.com/docs/guides/whatsapp/groups/sending.md): Send a WhatsApp group message with a group ID in to, then follow the fan-out through the three recipient counters and one event per participant. - [Unsupported WhatsApp message types](https://bird.com/docs/guides/whatsapp/receiving-whatsapp/unsupported.md): Understand received WhatsApp messages with unavailable content, Meta error 131051, and unsupported types such as polls, pins, and edits. - [Use read acknowledgements, typing and reactions](https://bird.com/docs/guides/whatsapp/read-typing-and-reactions.md): Use WhatsApp read acknowledgements, typing and reactions in a service exchange, with clear event handling and separate customer outcomes. - [WhatsApp audio messages](https://bird.com/docs/guides/whatsapp/message-types/audio.md): Send a voice note or audio clip by URL on WhatsApp, its size limit, the voice flag, and how to read an inbound audio message. - [WhatsApp authentication templates](https://bird.com/docs/guides/whatsapp/templates/authentication.md): Send a one-time passcode over WhatsApp with an authentication template, including the copy-code button and the business verification gate. - [WhatsApp coexistence](https://bird.com/docs/guides/whatsapp/coexistence.md): Use the same number in the WhatsApp Business app and Bird. Compare coexistence limits and costs, and identify messages sent from the app. - [WhatsApp contact cards](https://bird.com/docs/guides/whatsapp/message-types/contact-cards.md): Send up to five contact cards on WhatsApp, the name and length limits Bird enforces, what earns a card a tappable button, and how a card reads back. - [WhatsApp contact info requests](https://bird.com/docs/guides/whatsapp/message-types/interactive/contact-info-requests.md): Ask a WhatsApp recipient to share a phone number with a single button, and read the contact card they send back. - [WhatsApp conversations](https://bird.com/docs/guides/whatsapp/conversations.md): Reply to WhatsApp customers from the Bird dashboard, organize conversations with labels and assignments, and take over from an AI agent. - [WhatsApp document messages](https://bird.com/docs/guides/whatsapp/message-types/documents.md): Send a PDF, spreadsheet, or other file by URL on WhatsApp, its size and filename limits, and how to read an inbound document. - [WhatsApp group webhooks](https://bird.com/docs/guides/whatsapp/webhooks/groups.md): Payloads for the two WhatsApp group webhooks, fired when someone asks to join a group that requires approval and when they cancel that request. - [WhatsApp groups](https://bird.com/docs/guides/whatsapp/groups.md): Run a conversation with several customers at once in one WhatsApp chat: what groups are for, who can create them, and how people join by invite link. - [WhatsApp image messages](https://bird.com/docs/guides/whatsapp/message-types/images.md): Send a photo or graphic by URL on WhatsApp, its size and caption limits, and how to read an inbound image a contact sent you. - [WhatsApp inbound message webhooks](https://bird.com/docs/guides/whatsapp/webhooks/messages.md): The whatsapp.received webhook payload, which carries an inbound WhatsApp message's full content so your endpoint can act on it without fetching it. - [WhatsApp interactive messages](https://bird.com/docs/guides/whatsapp/message-types/interactive.md): Send reply buttons, list menus, link buttons, media carousels, and location or contact requests inside an open customer service window. - [WhatsApp keyword rules](https://bird.com/docs/guides/whatsapp/opt-outs/keyword-rules.md): The words Bird answers on your WhatsApp numbers, how an inbound message is matched against them, and how to change the reply or add keywords of your own. - [WhatsApp link buttons](https://bird.com/docs/guides/whatsapp/message-types/interactive/cta-url-buttons.md): Send a WhatsApp message with one call-to-action button that opens a URL, and see what a tap does and does not report back. - [WhatsApp list menus](https://bird.com/docs/guides/whatsapp/message-types/interactive/list-menus.md): Send a WhatsApp list menu of up to ten rows across its sections, and read which row slug the recipient tapped from the reply. - [WhatsApp location messages](https://bird.com/docs/guides/whatsapp/message-types/location.md): Send a pin with a latitude and longitude on WhatsApp, its coordinate and text limits, and how an inbound location shared by a contact reads back. - [WhatsApp location requests](https://bird.com/docs/guides/whatsapp/message-types/interactive/location-requests.md): Ask a WhatsApp recipient to share their location with a single button, and read the coordinates that come back as an inbound message. - [WhatsApp log](https://bird.com/docs/guides/whatsapp/message-log.md): Browse, filter, and inspect every WhatsApp message your workspace sends from the Messages page: statuses, the per-message event timeline, and delivery detail. - [WhatsApp marketing templates](https://bird.com/docs/guides/whatsapp/templates/marketing.md): Send a promotional WhatsApp message with a marketing template, including the business account you need and the opt-out expectation. - [WhatsApp media carousels](https://bird.com/docs/guides/whatsapp/message-types/interactive/carousels.md): Send two to ten swipeable WhatsApp cards, each with its own image or video and buttons, and read which card the recipient acted on. - [WhatsApp message status events](https://bird.com/docs/guides/whatsapp/events/message-status.md): Read a WhatsApp message's delivery timeline through the events API, from acceptance to delivery, read, failure, or rejection, and filter it by type. - [WhatsApp message status webhooks](https://bird.com/docs/guides/whatsapp/webhooks/message-status.md): Payloads for the WhatsApp message status webhooks, from whatsapp.accepted through sent and delivered to whatsapp.read, failed, or rejected. - [WhatsApp metrics](https://bird.com/docs/guides/whatsapp/tracking-and-metrics.md): Read the WhatsApp Metrics page in the Bird dashboard: delivery and failure rates, accepted volume, failure causes, latency, and breakdowns. - [WhatsApp numbers](https://bird.com/docs/guides/whatsapp/numbers/overview.md): Connect WhatsApp numbers to Bird, compare setup options, check connection status, update business profiles, and enable Conversations for your team. - [WhatsApp opt-outs and keywords](https://bird.com/docs/guides/whatsapp/opt-outs.md): What stops a WhatsApp message reaching someone, how suppressions and recipient preferences differ, and where each record lives in your workspace. - [WhatsApp overview](https://bird.com/docs/guides/whatsapp/overview.md): How Bird WhatsApp works: send templates from a Bird-managed or your own number, receive messages, track delivery, and find each guide. - [WhatsApp plain text messages](https://bird.com/docs/guides/whatsapp/message-types/plain-text.md): Send a WhatsApp message that carries only a body and an optional link preview, its length limit, and how an inbound reply reads back. - [WhatsApp preferences](https://bird.com/docs/guides/whatsapp/opt-outs/preferences.md): How a recipient states that they want fewer WhatsApp messages, what coverage each statement carries, and which of them your workspace can reverse. - [WhatsApp reaction events](https://bird.com/docs/guides/whatsapp/events/reactions.md): Read the reactions standing on a WhatsApp message and the log of every reaction change, by contacts and by your business number, through the Bird API. - [WhatsApp reaction webhooks](https://bird.com/docs/guides/whatsapp/webhooks/reactions.md): The whatsapp.reacted payload for a contact adding, changing, or removing an emoji reaction, and why the events cannot be ordered to rebuild the current state. - [WhatsApp reply buttons](https://bird.com/docs/guides/whatsapp/message-types/interactive/reply-buttons.md): Send up to three tappable quick-reply buttons on a WhatsApp message and read which one the recipient chose from the reply. - [WhatsApp service messages](https://bird.com/docs/guides/whatsapp/message-types.md): The nine content arms a WhatsApp service message can carry, the customer service window that gates delivery, sending media by URL, and what a failed fetch costs. - [WhatsApp sticker messages](https://bird.com/docs/guides/whatsapp/message-types/stickers.md): Send a WebP sticker by URL on WhatsApp, its size limits for static and animated stickers, and how to read an inbound sticker. - [WhatsApp suppression webhooks](https://bird.com/docs/guides/whatsapp/webhooks/suppressions.md): The whatsapp_suppression.created payload, which fires when a suppression opens so your own systems can mirror new blocks without polling the list. - [WhatsApp suppressions](https://bird.com/docs/guides/whatsapp/opt-outs/suppressions.md): Record, read, and end the WhatsApp addresses your workspace will not message, from the dashboard or the suppressions API, and scope each one correctly. - [WhatsApp templates](https://bird.com/docs/guides/whatsapp/templates.md): Browse the WhatsApp templates a workspace can send, inspect each one's category, languages, and variables, then send it by slug. - [WhatsApp utility templates](https://bird.com/docs/guides/whatsapp/templates/utility.md): Send order updates, appointment reminders, and account notices over WhatsApp with a utility template, and fill its variables correctly. - [WhatsApp video messages](https://bird.com/docs/guides/whatsapp/message-types/video.md): Send a video clip by URL on WhatsApp, its size and caption limits, and how to read an inbound video a contact sent you. - [WhatsApp webhooks](https://bird.com/docs/guides/whatsapp/webhooks.md): The WhatsApp webhook events Bird can push to your endpoint, the envelope every one arrives in, and the fields a message event always carries. ## Apple Messages guides - [Add Apple Messages entry points](https://bird.com/docs/guides/apple-messages/entry-points.md): Create conversation links and prepare website buttons, Apple Maps, Message Suggest, and QR entry points for your approved Apple business. - [Apple Messages for Business guides](https://bird.com/docs/guides/apple-messages.md): Set up Apple Messages for Business, reply to customers, create native messages, and manage channel operations in the Bird dashboard. - [Build an Apple Messages experience](https://bird.com/docs/guides/apple-messages/build-an-experience.md): Build an Apple Messages conversation with welcome messages, useful choices, human handoff, recovery paths, confirmations, and customer feedback. - [Choose and create native Apple Messages](https://bird.com/docs/guides/apple-messages/rich-messages.md): Choose a native Apple message type, build quick replies or a list picker, and understand received bubbles, customer answers, and device support. - [Complete Apple Messages onboarding](https://bird.com/docs/guides/apple-messages/onboarding.md): Plan your Apple Messages service, connect your account, prepare your team, pass Apple's Experience Review, and launch with a monitoring plan. - [Connect Wallet passes to Apple Messages](https://bird.com/docs/guides/apple-messages/wallet.md): Prepare a Wallet pass contact link and an external pass-distribution flow without confusing a Messages link with pass issuance or updates. - [Create a native Apple Messages form](https://bird.com/docs/guides/apple-messages/forms.md): Build a branching Apple Messages form in the template editor, configure page routes and validation, and inspect the customer's submitted answers. - [Create and send Apple Messages templates](https://bird.com/docs/guides/apple-messages/templates.md): Create a reusable Apple Messages draft, configure native content and variables, and review the actual recipient and message before sending. - [Inspect Apple Messages history and failures](https://bird.com/docs/guides/apple-messages/messages.md): Find incoming and outgoing Apple Messages, inspect their content and event history, and investigate a failed or uncertain send in Bird. - [Manage Apple Messages conversations](https://bird.com/docs/guides/apple-messages/conversations.md): Find Apple Messages conversations, assign them to teammates, add labels, send replies, and understand customer and device context. - [Manage Apple Messages suppressions](https://bird.com/docs/guides/apple-messages/suppressions.md): Inspect and create Apple Messages suppressions, choose business or workspace scope, and understand what ending a suppression changes. - [Measure Apple Messages business outcomes](https://bird.com/docs/guides/apple-messages/outcomes.md): Connect Apple Messages conversations to confirmed bookings, orders, and service results without treating message acceptance as business success. - [Move Apple Messages from Infobip to Bird](https://bird.com/docs/guides/apple-messages/migrate/infobip.md): Inventory an Infobip Apple Messages service, map native content and operator tasks to Bird, and plan a provider transition with verified boundaries. - [Move Apple Messages from LivePerson to Bird](https://bird.com/docs/guides/apple-messages/migrate/liveperson.md): Map LivePerson Structured Content and service operations to Bird, preserve historical records, and verify the Apple provider transition before cutover. - [Offer appointment times in Apple Messages](https://bird.com/docs/guides/apple-messages/appointments.md): Create a native time picker with dated slots and the correct time zone, then verify the customer's choice before confirming a booking. - [Plan AI and human service for Apple Messages](https://bird.com/docs/guides/apple-messages/ai-conversations.md): Define the responsibilities, knowledge, safeguards, and ownership handoff for an Apple Messages assistant before connecting a live service. - [Plan an Apple Messages customer journey](https://bird.com/docs/guides/apple-messages/journeys.md): Define an Apple Messages service from entry point to confirmed result, including staff responsibilities, failure paths, and launch evidence. - [Prepare your Apple Messages demo](https://bird.com/docs/guides/apple-messages/experience-review.md): Record a complete Apple Messages experience on iPhone, demonstrate handoff and recovery, check the evidence, and submit it through Bird. - [Read Apple Messages channel metrics](https://bird.com/docs/guides/apple-messages/analytics.md): Use Bird's outbound, inbound, and conversation reports to understand Apple Messages activity, processing failures, and first-response times. - [Register your business for Apple Messages](https://bird.com/docs/guides/apple-messages/registration.md): Connect an Apple business to Bird, prepare the required review documents and service demonstration, and check readiness before launch. - [Reply through the Apple Messages API](https://bird.com/docs/guides/apple-messages/api.md): Find an open Apple Messages conversation, send a text reply through Bird's public API, and handle message events and business outcomes safely. - [Send an Apple Messages app experience](https://bird.com/docs/guides/apple-messages/custom-apps.md): Configure a published iMessage app or App Clip in an Apple Messages template and verify its identity, payload, and behavior on a device. - [Send images and files in Apple Messages](https://bird.com/docs/guides/apple-messages/attachments.md): Prepare a publicly fetchable image or document, configure an Apple Messages attachment template, and investigate media-processing failures. - [Send rich links and locations in Apple Messages](https://bird.com/docs/guides/apple-messages/links.md): Configure a rich link with your own preview, request an Apple-generated preview, or share a location through an Apple Messages template. - [Troubleshoot Apple Messages for Business](https://bird.com/docs/guides/apple-messages/troubleshooting.md): Diagnose undelivered test messages, missing conversations, disabled replies, failed native messages, lost template drafts, and unexpected reporting results. ## Voice guides - [Build and edit a voice sequence](https://bird.com/docs/guides/voice/sequences/editor.md): Add call entries and steps, connect their outcomes, edit settings and data mappings, and save a voice sequence draft for preview and publication. - [Call log](https://bird.com/docs/guides/voice/call-log.md): Browse, filter, and export the legs of your workspace's calls, and read why a connection was refused: statuses, timings, billable time, and cost. - [Caller IDs](https://bird.com/docs/guides/voice/caller-ids.md): Register the numbers your workspace presents on outbound calls and prove you own them with a verification call, on the Numbers page in the dashboard. - [Check and simulate a voice sequence](https://bird.com/docs/guides/voice/sequences/preview.md): Validate a sequence draft, simulate call paths with entry data and sample outcomes, and inspect prepared steps without placing a call. - [Choose voice sequence steps](https://bird.com/docs/guides/voice/sequences/nodes.md): Find call entries, media, keypad input, dialing, transfers, and ending steps in the Voice sequence catalog and choose the right outcome paths. - [Configure sequence prompts and keypad menus](https://bird.com/docs/guides/voice/sequences/media-and-keypad.md): Add ordered speech and audio, collect keypad choices with interruptible prompts, and define silence, unmatched-input, and recording behavior. - [Create a voice call](https://bird.com/docs/guides/voice/create-calls.md): Start an outbound call with a published Voice sequence or an inline definition through the API, inspect its result, and learn about the CLI and MCP preview. - [Design a call sequence](https://bird.com/docs/guides/voice/call-sequences.md): Plan prompts, keypad choices, recording, and test cases for a Voice call flow, then build a sequence or connect your own SIP application. - [Dial and transfer calls in a sequence](https://bird.com/docs/guides/voice/sequences/dial-and-transfer.md): Connect callers to a phone destination, handle busy and unanswered calls, or transfer control to another sequence entry or managed service. - [Inspect voice sequence runs](https://bird.com/docs/guides/voice/sequences/runs.md): Inspect the saved definition, mode, call references, and step occurrences of a sequence run, and request cancellation of active call work. - [Migrate Voice from Bandwidth](https://bird.com/docs/guides/voice/migrate/bandwidth.md): Plan a Voice migration from Bandwidth to Bird by mapping calling behavior, preparing the connection and testing the full customer journey before cutover. - [Migrate Voice from Bland](https://bird.com/docs/guides/voice/migrate/bland.md): Plan a Voice migration from Bland to Bird by mapping calling behavior, preparing the connection and testing the full customer journey before cutover. - [Migrate Voice from Plivo](https://bird.com/docs/guides/voice/migrate/plivo.md): Plan a Voice migration from Plivo to Bird by mapping calling behavior, preparing the connection and testing the full customer journey before cutover. - [Migrate Voice from Telnyx](https://bird.com/docs/guides/voice/migrate/telnyx.md): Plan a Voice migration from Telnyx to Bird by mapping calling behavior, preparing the connection and testing the full customer journey before cutover. - [Migrate Voice from Twilio](https://bird.com/docs/guides/voice/migrate/twilio.md): Plan a Voice migration from Twilio to Bird by mapping calling behavior, preparing the connection and testing the full customer journey before cutover. - [Migrate Voice from Vapi](https://bird.com/docs/guides/voice/migrate/vapi.md): Plan a Voice migration from Vapi to Bird by mapping calling behavior, preparing the connection and testing the full customer journey before cutover. - [Migrate Voice from Vonage](https://bird.com/docs/guides/voice/migrate/vonage.md): Plan a Voice migration from Vonage to Bird by mapping calling behavior, preparing the connection and testing the full customer journey before cutover. - [Phone](https://bird.com/docs/guides/voice/phone.md): Place calls from the Bird dashboard over your own SIP trunk: what a browser call needs, the controls during a call, and where the calls show up. - [Place your first call](https://bird.com/docs/guides/voice/first-call.md): Place a browser call through a SIP trunk, confirm two-way audio, and inspect the resulting call record in the dashboard or Voice API. - [Placing calls](https://bird.com/docs/guides/voice/placing-calls.md): What has to be true before your first outbound call, what Bird expects on the SIP INVITE, how the Digest handshake works, and how a call is priced. - [Publish and manage voice sequences](https://bird.com/docs/guides/voice/sequences/publishing.md): Publish a saved sequence, restore an earlier version to draft, and manage pause, archive, duplication, and deletion without changing calls in progress. - [Read voice sequence metrics](https://bird.com/docs/guides/voice/sequences/metrics.md): Compare sequence run counts, success and completion rates, elapsed durations, publications, and outcome reasons with the right mode and period. - [Receiving calls](https://bird.com/docs/guides/voice/receiving-calls.md): Route an incoming Voice call to a SIP trunk, verified number, or published sequence, and inspect the route and outcome recorded for each call. - [Recordings and transcripts](https://bird.com/docs/guides/voice/recordings.md): Plan Voice capture and review: identify the source call, verify audio and transcript state, and keep access, retention and business outcomes explicit. - [SIP client setup](https://bird.com/docs/guides/voice/sip-clients.md): Point a softphone or a PBX at a Bird SIP trunk, with the settings every client needs and worked configurations for Asterisk, FreePBX, Zoiper, and baresip. - [SIP trunks](https://bird.com/docs/guides/voice/sip-trunks.md): Create a SIP trunk, turn on each direction, read its connection details, and control which addresses, API keys, and session credentials may send calls to it. - [Start an Automation from a voice sequence](https://bird.com/docs/guides/voice/sequences/automations.md): Send an application event from a call to start an Automation without waiting for it, and map caller, call and keypad data into the event. - [Start from a voice sequence template](https://bird.com/docs/guides/voice/sequences/templates.md): Choose a call-flow template, inspect its example scenarios, and configure an independent sequence draft with your own prompts and destinations. - [Test a voice sequence with real calls](https://bird.com/docs/guides/voice/sequences/testing.md): Call a saved draft or published sequence, route selected incoming callers to a draft, and verify prompts, keypad paths, and telephone outcomes. - [Troubleshoot a voice sequence](https://bird.com/docs/guides/voice/sequences/troubleshooting.md): Find why a sequence is unavailable, preview stops, publication fails, a call takes the wrong version, or cancellation and reporting remain pending. - [Use data in a voice sequence](https://bird.com/docs/guides/voice/sequences/data.md): Define call-entry fields, map values into sequence steps, and handle optional caller information and fresh data scopes after a transfer. - [Voice destinations](https://bird.com/docs/guides/voice/destinations.md): Choose the countries your workspace calls by enabling them on the Destinations page, and read what the availability and high risk labels mean on that list. - [Voice events](https://bird.com/docs/guides/voice/events.md): The three voice call webhook events, what each one means in the life of a call, the fields they carry, and how to consume them without double counting. - [Voice metrics](https://bird.com/docs/guides/voice/tracking-and-metrics.md): Read your voice analytics in the Bird dashboard: answer-seizure ratio, average call duration, call outcomes, top countries, and direction. - [Voice overview](https://bird.com/docs/guides/voice/overview.md): What Bird Voice is, how a call travels between your phone system and the telephone network over a SIP trunk, and where your calls show up. - [Voice sequence node reference](https://bird.com/docs/guides/voice/sequences/node-reference.md): Look up the generally available steps for an inline voice sequence definition, with each type, its fields, allowed values, and outcomes. - [Voice sequences](https://bird.com/docs/guides/voice/sequence-builder.md): Build call flows with prompts, keypad choices, and transfers, then preview, test, publish, and inspect their runs in the Bird dashboard. - [Voice troubleshooting](https://bird.com/docs/guides/voice/troubleshooting.md): Diagnose a Bird Voice call from its symptom: missing from the call log, rejected with or without a reason, an incoming call nobody answers, or one-way audio. ## eSIM guides - [Assign eSIMs to employees](https://bird.com/docs/guides/esim/employee-connectivity.md): Purchase and assign an eSIM to an employee, send private installation instructions, monitor packages, and stop renewal when service ends. - [Buy and deliver a travel eSIM](https://bird.com/docs/guides/esim/travel.md): Choose a package for a travel itinerary, purchase it in the dashboard, deliver installation instructions, and check data during the trip. - [Check device and coverage requirements](https://bird.com/docs/guides/esim/device-and-coverage.md): Check the device, carrier lock, covered destinations, identification requirements, and package validity before buying or installing a Bird eSIM. - [Embed eSIM connectivity in your app](https://bird.com/docs/guides/esim/embedded-connectivity.md): Build an eSIM purchase and installation flow in your app, retain customer references, and provide usage, top-ups, and recovery. - [Inspect usage and add a top-up](https://bird.com/docs/guides/esim/usage-and-top-ups.md): Check reported eSIM package balances, choose a compatible top-up, and confirm delivery without duplicating an existing purchase. - [Install and share an eSIM](https://bird.com/docs/guides/esim/installation.md): Open an eSIM installation page, send a private setup link, install on iPhone or Android, and verify mobile data in a covered destination. - [Integrate the eSIM API](https://bird.com/docs/guides/esim/api.md): Choose an eSIM offer, create a purchase, deliver installation details, and recover interrupted requests using the Bird eSIM API. - [Manage recurring eSIM packages](https://bird.com/docs/guides/esim/mobile-plans.md): Enable recurring data packages on a new or existing eSIM, verify payment and package delivery, and cancel future renewal while preserving purchased data. - [Resolve an eSIM service issue](https://bird.com/docs/guides/esim/operations.md): Identify an eSIM purchase, funding, installation, or connectivity issue and use its recorded outcome to choose the next recovery step. - [eSIM connectivity guide](https://bird.com/docs/guides/esim/overview.md): Choose a Bird eSIM package, purchase and install it, then manage data, top-ups, automatic renewal, and customer support. ## Realtime guides - [Authorizing channels](https://bird.com/docs/guides/realtime/authorizing-channels.md): Sign private and presence channel subscriptions from your backend so only the clients you approve can subscribe, and presence members carry an identity. - [Cache channels](https://bird.com/docs/guides/realtime/cache-channels.md): Cache channels replay their latest event to new subscribers, giving late arrivals current state without waiting for another publish. - [Client events](https://bird.com/docs/guides/realtime/client-events.md): Let clients send events straight to each other on private and presence channels, for typing indicators, cursors, and other signals your server never needs. - [Connection lifecycle and reconnection](https://bird.com/docs/guides/realtime/connection-lifecycle.md): The six states a Realtime connection moves through, how the client reconnects after a drop, and which close codes it refuses to retry. - [Encrypted channels](https://bird.com/docs/guides/realtime/encrypted-channels.md): Channels named private-encrypted- seal payloads with a key only you hold, preventing the Realtime edge and intermediaries from reading them. - [Excluding event recipients](https://bird.com/docs/guides/realtime/excluding-event-recipients.md): Skip the client that caused a change when you publish, so it does not apply its own update twice, using its connection ID. - [Presence channels](https://bird.com/docs/guides/realtime/presence-channels.md): Presence channels track who is subscribed, giving each client the member list and events as members join and leave the channel. - [Private channels](https://bird.com/docs/guides/realtime/private-channels.md): Private channels require your backend to approve every subscription, so only the clients you sign for can receive events on them. - [Public channels](https://bird.com/docs/guides/realtime/public-channels.md): Use public Realtime channels to broadcast data that anyone can read, without adding a subscription authorization endpoint. - [Publishing events](https://bird.com/docs/guides/realtime/publishing-events.md): Publish events to Realtime channels from your server, broadcast to many channels at once, batch unrelated events, and exclude the client that acted. - [Querying channel state](https://bird.com/docs/guides/realtime/querying-channel-state.md): Read which Realtime channels are occupied, whether one channel has anybody on it, and who is present on a presence channel, from your server. - [Realtime overview](https://bird.com/docs/guides/realtime/overview.md): How Realtime delivers events over WebSockets, covering channels, members and connections, the three channel types, and where usage shows up. - [Realtime webhooks](https://bird.com/docs/guides/realtime/webhooks.md): Have the Realtime edge tell your server what is happening on your channels: occupancy, presence, connection counts, cache misses, and client events. - [Requiring authorized connections](https://bird.com/docs/guides/realtime/authorized-connections.md): Close connections that never prove they are authorized, so a leaked app key cannot be used to hold open sockets against your app. - [Sending events to a member](https://bird.com/docs/guides/realtime/sending-events-to-a-member.md): Send an event to one person instead of a channel, and it reaches every connection they hold, on every tab and device they are signed in on. - [Terminating member connections](https://bird.com/docs/guides/realtime/terminating-member-connections.md): Give a connection a member identity, then close every connection that member holds when you sign them out, ban them, or revoke a session. - [Watchlist events](https://bird.com/docs/guides/realtime/watchlist-events.md): Tell a signed-in member when the members they care about come online or go offline, without a channel subscription for every relationship. ## Verify guides - [Country configuration](https://bird.com/docs/guides/verify/countries.md): Control where Verify delivers codes. Enable or disable countries, set the per-country channel order, and pin per-country senders. - [Migrate Verify from Prelude](https://bird.com/docs/guides/verify/migrate/prelude.md): Map Prelude's v2 verification create and check to Bird Verify, translate statuses and channels, and plan for signals and silent verification. - [Migrate Verify from Twilio](https://bird.com/docs/guides/verify/migrate/twilio.md): Map Twilio Verify's Services, Verifications, and VerificationCheck to Bird Verify, translate statuses and channels, and cut over without stranding codes. - [Migrate Verify from another provider](https://bird.com/docs/guides/verify/migrate.md): Move one-time passcodes to Bird Verify: map create and check, set channels and countries, port the lifecycle, switch webhooks, and cut over safely. - [Senders and branding](https://bird.com/docs/guides/verify/senders.md): Choose Bird-managed or workspace senders for Verify email, SMS, and WhatsApp. Learn how country overrides and SMS sender fallback work. - [Sending verifications](https://bird.com/docs/guides/verify/sending-verifications.md): Send a one-time passcode with the Verify API and confirm it with the check endpoint: recipients, options, message language, statuses, resends, settings, and limits. - [Verify best practices](https://bird.com/docs/guides/verify/best-practices.md): How to set a passcode's length and lifetime, which channel to use for what, and where Bird's defaults already meet NIST SP 800-63B and where a setting can take you outside it. - [Verify events](https://bird.com/docs/guides/verify/events.md): The verify.* webhook event catalog: the verification lifecycle, each passcode attempt's delivery journey, payload fields, and how to consume them. - [Verify overview](https://bird.com/docs/guides/verify/overview.md): What Bird Verify is, how the send-and-check passcode flow works, which channels deliver codes, and where every guide in this section lives. ## Numbers guides - [Buy and release a number](https://bird.com/docs/guides/numbers/buying-numbers.md): Search the numbers on sale in a country, order one, poll an order that does not finish immediately, and release a dedicated number you no longer need. - [Managing your phone numbers](https://bird.com/docs/guides/numbers/managing-numbers.md): List and find the numbers allocated to your workspace, label them with a name and your own reference, look up their voice record, and cancel or release them over the API. - [Migrate from Telserv to Bird](https://bird.com/docs/guides/numbers/migrate/telserv.md): Move a Telserv partner API integration to the Bird API, map each operation group to its Bird call, and see how each job is done in Bird. - [Number types](https://bird.com/docs/guides/numbers/number-types.md): What a number's mobile, local, national, toll-free or short-code type decides, how to choose between them, and which registration each one needs. - [Numbers overview](https://bird.com/docs/guides/numbers/overview.md): What a Bird phone number is, how dedicated and shared numbers differ, what each type of number can carry, and where every guide in this section lives. ## Lookup guides - [Look up a phone number](https://bird.com/docs/guides/lookup/phone-numbers.md): Run a base phone number lookup, add paid properties such as porting and presence, read the status on each block, and handle the errors a lookup can return. - [Look up an email address](https://bird.com/docs/guides/lookup/email-addresses.md): Check whether an email address is worth sending to, read the five verdicts and the confidence score, and decide what to do with each result before you send. - [Lookup overview](https://bird.com/docs/guides/lookup/overview.md): What Lookup answers about a phone number or an email address, how the free baseline differs from the paid properties, and what each request costs you. ## Automations guides - [Automations](https://bird.com/docs/guides/automations.md): Build workflows in the Bird dashboard with triggers, messaging, and decisions, then preview, publish, and inspect their runs. - [Build and edit a flow](https://bird.com/docs/guides/automations/editor.md): Add and configure automation steps on the canvas, connect outcome paths, create ordered branches, and save a draft for review. - [Choose an automation trigger](https://bird.com/docs/guides/automations/triggers.md): Choose an application event, incoming Bird message, or schedule to start a workflow, and understand what data reaches its steps. - [Choose automation nodes](https://bird.com/docs/guides/automations/nodes.md): Find the trigger, logic, messaging, contact, audience, preference, and lookup nodes available when building workflows in the Automations dashboard. - [Connect your application to an automation](https://bird.com/docs/guides/automations/application-events.md): Send application events to start automation runs, continue waiting runs, and handle retries with the correct URL, event data, and business key. - [Control overlapping runs and cancellation](https://bird.com/docs/guides/automations/run-settings.md): Use automation settings to prevent overlapping work, group active runs by a business key, and stop runs when a cancellation event arrives. - [Flows, nodes, and connections](https://bird.com/docs/guides/automations/flows.md): Understand how an automation follows connected steps, chooses branches, passes data, and keeps draft changes separate from live runs. - [Preview and check a workflow](https://bird.com/docs/guides/automations/preview.md): Validate an automation draft, simulate paths with sample data, and inspect prepared inputs without sending messages or changing records. - [Publish and manage automations](https://bird.com/docs/guides/automations/publishing.md): Save drafts, publish reviewed versions, restore earlier work, and pause, duplicate, archive, or delete automations from the dashboard. - [Read automation metrics](https://bird.com/docs/guides/automations/metrics.md): Understand automation run counts, success rates, duration, version comparisons, and outcome reasons without confusing them with delivery. - [Schedule runs and delay steps](https://bird.com/docs/guides/automations/schedules-and-delays.md): Configure recurring automation schedules and pauses between steps, with guidance on timezones, missed runs, and overlapping work. - [Send messages in an automation](https://bird.com/docs/guides/automations/messages.md): Configure SMS, email, and WhatsApp steps with senders, recipients, content, and data mappings, then handle acceptance and delivery. - [Start and inspect automation runs](https://bird.com/docs/guides/automations/runs.md): Start a published automation manually, inspect its recorded steps and results, and cancel active work from the dashboard Runs view. - [Start from an automation template](https://bird.com/docs/guides/automations/templates.md): Choose a workflow template, review its requirements and sample scenarios, and configure an independent draft in the Bird dashboard. - [Troubleshoot an automation](https://bird.com/docs/guides/automations/troubleshooting.md): Find why an automation does not start, a preview stops, a field is unavailable, or a run waits, fails, or completes without delivery. - [Use data from earlier steps](https://bird.com/docs/guides/automations/data.md): Map trigger fields, step outputs, and variables into automation inputs, and handle missing values when a workflow takes different paths. - [Use preferences and lookups](https://bird.com/docs/guides/automations/preferences-and-lookups.md): Read or record messaging preferences and assess phone numbers or email addresses, then branch on the actual result of each action. - [Wait for a customer reply in Automations](https://bird.com/docs/guides/automations/wait-for-reply.md): Continue an automation when a customer replies to an SMS or WhatsApp message. Configure reply paths, timeouts, and follow-up actions in the dashboard. - [Wait for an event](https://bird.com/docs/guides/automations/waits.md): Continue a workflow after a message receipt or application event, and configure timeout paths when the expected event does not arrive. - [Work with contacts and audiences](https://bird.com/docs/guides/automations/contacts-and-audiences.md): Read and update contacts, manage static audience memberships, and handle empty searches, paginated lists, and partial batch results. ## API guides - [Authentication](https://bird.com/docs/api/authentication.md): Wire-level authentication for the Bird API: the bearer header, API key anatomy, and the exact failure responses. - [Base URLs and regions](https://bird.com/docs/api/regions.md): Regional base URLs, the organization-level region model, automatic client routing, and errors for requests sent to the wrong region. - [Deprecations](https://bird.com/docs/api/deprecations.md): How the Bird API signals a deprecation: the Deprecation response header, what a superseded request field or query parameter still does, and how to migrate off one. - [Error responses](https://bird.com/docs/api/errors.md): The error response wire contract: the envelope fields, HTTP status mapping, validation details, and how each SDK surfaces failures. - [Idempotency-Key header](https://bird.com/docs/api/idempotency.md): The Idempotency-Key wire contract: header format, replay semantics, conflict errors, retention, and how the SDKs auto-key retries. - [Introduction](https://bird.com/docs/api.md): Orientation for the Bird API reference: how it is organized, the conventions every endpoint follows, and where to start. - [Pagination](https://bird.com/docs/api/pagination.md): The cursor pagination wire contract, covering limit, starting_after, ending_before, opaque cursors, opt-in totals, and how the SDKs iterate for you. ## SDKs - [Go SDK](https://bird.com/docs/sdks/go.md): Install and configure github.com/messagebird/bird-sdk-go, including client construction, typed errors, safe retries, pagination, and webhooks. - [Kotlin SDK](https://bird.com/docs/sdks/kotlin.md): Install bird-realtime, subscribe to a channel, authorize private and presence channels, and sign in a member from an Android or server JVM app. - [PHP SDK](https://bird.com/docs/sdks/php.md): Install and configure messagebird/sdk, send your first request, and learn the client's retry, idempotency, and error model. - [Python SDK](https://bird.com/docs/sdks/python.md): Install and configure the Bird Python SDK, including sync and async clients, typed errors, safe retries, pagination, and webhooks. - [SDK concepts](https://bird.com/docs/sdks/concepts.md): Learn the shared Bird SDK behavior for idempotency, retries, pagination, region inference, per-call options, and webhook verification. - [SDKs](https://bird.com/docs/sdks.md): Explore typed SDKs for TypeScript, Python, Go, and PHP, plus Realtime WebSocket clients for Swift, Kotlin, and the browser. - [Swift SDK](https://bird.com/docs/sdks/swift.md): Install BirdRealtime, subscribe to a channel, authorize private and presence channels, and sign in a member from an Apple or Linux app. - [TypeScript SDK](https://bird.com/docs/sdks/typescript.md): Install and configure @messagebird/sdk, send your first request, and learn the client's retry, idempotency, and error model. ## CLI - [Bird CLI](https://bird.com/docs/cli.md): The bird command-line interface for operating the Bird API from a shell, a script, or an AI agent with JSON output, semantic exit codes, and safe retries. ## Knowledge base - [API key management](https://bird.com/docs/knowledge-base/account-security/api-keys.md): Create, scope, rotate, and revoke the API keys your applications use to call Bird, and learn how to store each secret securely. - [Acceptable use policy](https://bird.com/docs/knowledge-base/policies/acceptable-use.md): A plain-language summary of content you cannot send through Bird and the actions Bird may take when sending violates policy. - [Add DNS records · AWS Route 53](https://bird.com/docs/knowledge-base/dns-and-domains/route-53.md): Publish Bird's sending-domain DNS records in Route 53, including DKIM, return-path, DMARC, and optional tracking records. - [Add DNS records · Azure DNS](https://bird.com/docs/knowledge-base/dns-and-domains/azure.md): Click-by-click instructions for publishing Bird's sending-domain DNS records in an Azure DNS zone via the Azure portal. - [Add DNS records · Cloudflare](https://bird.com/docs/knowledge-base/dns-and-domains/cloudflare.md): Publish Bird's sending-domain DNS records in Cloudflare, including DKIM, return-path, DMARC, and optional tracking records. - [Add DNS records · DigitalOcean](https://bird.com/docs/knowledge-base/dns-and-domains/digitalocean.md): Step-by-step instructions for publishing Bird's sending-domain DNS records from the Domains page in the DigitalOcean control panel. - [Add DNS records · GoDaddy](https://bird.com/docs/knowledge-base/dns-and-domains/godaddy.md): Publish Bird's sending-domain DNS records in GoDaddy, including DKIM, return-path, DMARC, and optional tracking records. - [Add DNS records · Google Domains / Squarespace](https://bird.com/docs/knowledge-base/dns-and-domains/google-domains.md): Click-by-click instructions for publishing Bird's sending-domain DNS records in Squarespace Domains, where Google Domains now lives. - [Add DNS records · Namecheap](https://bird.com/docs/knowledge-base/dns-and-domains/namecheap.md): Publish Bird's sending-domain DNS records in Namecheap, including DKIM, return-path, DMARC, and optional tracking records. - [Add DNS records · any registrar](https://bird.com/docs/knowledge-base/dns-and-domains/generic-registrar.md): A provider-agnostic walkthrough for publishing Bird's sending-domain DNS records at any registrar: finding the zone editor and copying host and value fields. - [Apple Mail Privacy and open tracking](https://bird.com/docs/knowledge-base/deliverability/apple-mail-privacy.md): Why open rates look inflated since Apple Mail Privacy Protection, how Bird identifies likely machine prefetches, and which signals to trust. - [Audit log](https://bird.com/docs/knowledge-base/account-security/audit-log.md): Review a chronological record of changes in your organization and use it for security reviews, investigations, and incident follow-up. - [Avoiding the spam folder](https://bird.com/docs/knowledge-base/deliverability/spam-folder.md): The three levers that decide whether mail lands in the inbox or spam: authentication, content, and list quality, plus what to do about each one. - [Common error messages](https://bird.com/docs/knowledge-base/troubleshooting/common-errors.md): A plain-language glossary of the API errors people hit most often: what each one means, the likely cause, and the fix. - [Create an account and workspace](https://bird.com/docs/knowledge-base/getting-started/create-account.md): Create a Bird account, verify your email address, learn what belongs to your workspace, and send a test email. - [Dashboard tour](https://bird.com/docs/knowledge-base/getting-started/dashboard-tour.md): How the Bird dashboard is put together: the sidebar, how channels and resources are organized, the developer tools, and the controls that follow you everywhere. - [Deliverability FAQ](https://bird.com/docs/knowledge-base/faq/deliverability.md): Quick answers to recurring questions about domain verification, IP warmup, blocked recipients, and open rates. - [Delivery delays and retries](https://bird.com/docs/knowledge-base/troubleshooting/delays.md): Why an email can take a while to arrive, what deferred and delivered mean, and where to watch a message work its way through delivery. - [Domain verification delays](https://bird.com/docs/knowledge-base/dns-and-domains/verification-delays.md): Why a sending domain can stay unverified after you've added the DNS records, and what to check while you wait. - [Email sending FAQ](https://bird.com/docs/knowledge-base/faq/email-sending.md): Answers to common questions about sending your first email, the shared onboarding domain, and setting up your own domain. - [Email · list consent and CAN-SPAM](https://bird.com/docs/knowledge-base/compliance/email/consent.md): What CAN-SPAM requires of your email, what valid list consent looks like, and how unsubscribes and one-click List-Unsubscribe headers work. - [Email · sender vetting and domain registration](https://bird.com/docs/knowledge-base/compliance/email/sender-vetting.md): What happens after you add a sending domain, covering how your DNS is checked, when the domain becomes verified, and why a verified domain can later flip back. - [Gmail and Yahoo sender requirements](https://bird.com/docs/knowledge-base/deliverability/gmail-yahoo-requirements.md): Gmail and Yahoo bulk-sender requirements for authentication, one-click unsubscribe, and low spam-complaint rates. - [Invite your team](https://bird.com/docs/knowledge-base/getting-started/invite-your-team.md): Invite teammates to your Bird workspace, choose the right role, and learn what happens when they accept or an invite expires. - [Knowledge base](https://bird.com/docs/knowledge-base.md): Practical help for using Bird: account setup, billing, DNS and domains, deliverability, compliance, and troubleshooting. - [List hygiene](https://bird.com/docs/knowledge-base/deliverability/list-hygiene.md): Why pruning invalid and inactive addresses protects your deliverability, what is suppressed automatically, and the habits that keep a list healthy. - [Login, password, and MFA](https://bird.com/docs/knowledge-base/account-security/login-mfa.md): Keep your Bird account secure: set a strong password, enable two-factor authentication, and review where you're signed in. - [Marketing templates](https://bird.com/docs/knowledge-base/whatsapp/marketing-templates.md): How a marketing template sends over Meta's Marketing Messages API, what the business account's onboarding status means, and where marketing is limited. - [Number quality and messaging limit](https://bird.com/docs/knowledge-base/whatsapp/number-quality-and-messaging-limit.md): Read your WhatsApp number's quality, shared portfolio messaging allowance, and send-rate status, then investigate changes before increasing volume. - [Payment methods and wallet](https://bird.com/docs/knowledge-base/billing/payment-methods-wallet.md): How the prepaid wallet works, adding and managing cards, topping up, auto top-up, low-balance alerts, and your billing details. - [Plan changes and renewals](https://bird.com/docs/knowledge-base/billing/plan-changes-and-renewals.md): How upgrades, downgrades, and cancellation take effect, how renewals are funded from your wallet and card, and what happens when a payment fails. - [Plans and pricing](https://bird.com/docs/knowledge-base/billing/plans-and-pricing.md): Compare Bird's plan tiers: included email volume, sending limits, how overage works on paid plans, and how pay-as-you-go products like SMS are priced. - [SSO and provisioning](https://bird.com/docs/knowledge-base/account-security/sso.md): Configure SAML or OpenID Connect single sign-on, verify company domains, test the connection, and control how members sign in. - [Sender reputation monitoring](https://bird.com/docs/knowledge-base/deliverability/reputation-monitoring.md): Monitor bounce, complaint, and unsubscribe rates, interpret Bird's email-health labels, and respond before delivery problems spread. - [Sending from the shared domain](https://bird.com/docs/knowledge-base/dns-and-domains/shared-domain.md): What Bird's shared onboarding domain is for, who it can deliver to, and when to move to your own verified domain. - [Set up SSO with Google Workspace](https://bird.com/docs/knowledge-base/account-security/sso-google-workspace.md): Register a Bird SAML or OIDC connection in Google Workspace, turn off response signing, enable user access, and allow for Google's configuration lag. - [Set up SSO with Microsoft Entra ID](https://bird.com/docs/knowledge-base/account-security/sso-microsoft-entra-id.md): Register a Bird SAML or OIDC connection in Microsoft Entra ID, set the NameID format Entra omits, populate mail, and understand app assignment. - [Set up SSO with Okta](https://bird.com/docs/knowledge-base/account-security/sso-okta.md): Register a Bird SAML or OIDC connection in Okta, map Okta's field names to Bird's, choose a NameID format, and rotate the signing certificate. - [Status page and incidents](https://bird.com/docs/knowledge-base/status/status-and-incidents.md): How to read Bird's status page, subscribe to incident updates, and tell a platform incident apart from a problem with your own account. - [Supported countries and restrictions](https://bird.com/docs/knowledge-base/policies/supported-countries.md): Which markets Bird can serve, where sending is restricted by sanctions or local law, and how data residency regions work. - [The WhatsApp customer service window](https://bird.com/docs/knowledge-base/whatsapp/customer-service-window.md): The 24-hour customer service window on WhatsApp: when it opens, when it resets, and why reaching someone outside it takes an approved template. - [Usage, spend, and invoices](https://bird.com/docs/knowledge-base/billing/usage-and-invoices.md): Track usage against your plan on the Usage page, follow every wallet movement on the Spend page, and read your monthly invoices. - [Warming best practices](https://bird.com/docs/knowledge-base/deliverability/warming.md): Why new sending domains and dedicated IPs need a gradual volume ramp, how dedicated IPs are warmed automatically, and how to ramp your own sending safely. - [WhatsApp October 2026 pricing changes](https://bird.com/docs/knowledge-base/whatsapp/october-2026-pricing-changes.md): What Meta starts charging for on October 1st 2026, which nine countries gain a higher authentication rate, and what stays free. - [WhatsApp Official Business Account](https://bird.com/docs/knowledge-base/whatsapp/official-business-account.md): What Meta's Official Business Account status gives a WhatsApp number, the requirements behind it, and how to request it and read it in Bird. - [WhatsApp account restrictions and appeals](https://bird.com/docs/knowledge-base/whatsapp/account-restrictions-and-appeals.md): Find WhatsApp quality, restriction and ban states in Meta and Bird, request a review, and understand what Bird support can change. - [WhatsApp authentication-international rates](https://bird.com/docs/knowledge-base/whatsapp/authentication-international-rates.md): Why authentication codes to some countries cost more, what Meta checks before charging the higher rate, and how you learn your start times for each market. - [WhatsApp business verification](https://bird.com/docs/knowledge-base/whatsapp/business-verification.md): Prepare for Meta's business identity review, understand its relationship to WhatsApp limits, and check the resulting account status. - [WhatsApp sending FAQ](https://bird.com/docs/knowledge-base/faq/whatsapp-sending.md): Quick answers about sending WhatsApp through Bird: sending without a number of your own, the Notify and Verify senders, and connecting your own number. - [WhatsApp template guidelines](https://bird.com/docs/knowledge-base/whatsapp/template-guidelines.md): What Meta allows in a WhatsApp template: per-component character limits, variable rules, the review timeline, and the reasons templates get rejected. - [Why did my email bounce?](https://bird.com/docs/knowledge-base/troubleshooting/bounces.md): Distinguish retrying deferrals from final hard and soft bounces, see what Bird suppresses, and find the receiving server's exact response. - [Why does email health show Throttled?](https://bird.com/docs/knowledge-base/troubleshooting/throttled-paused.md): Understand the Throttled email-health label, the rates behind it, why it does not pause sending, and which delivery problems to investigate. - [Why is my WhatsApp business limited to 2 phone numbers](https://bird.com/docs/knowledge-base/whatsapp/unverified-business-account.md): Meta caps an unscaled business portfolio at two registered numbers. Scale the portfolio to raise the cap to 20, then retry the number that failed. - [Why pre-verification fails, and when to try again](https://bird.com/docs/knowledge-base/whatsapp/pre-verification-failures.md): Check the verification error, receiving capability, and retry time when WhatsApp cannot verify a business number. - [Why was my email rejected?](https://bird.com/docs/knowledge-base/troubleshooting/rejections.md): The common reasons Bird refuses a message or recipient before delivery is attempted: suppressed recipients, invalid addresses, rate limits, and policy. ## API references - [API index](https://bird.com/api/llms.txt): API guides, operations and public errors