> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Guides

> Practical guides for building with the YCloud API.

Use these guides to move from your first request to a production integration.

## Choose a workflow

Start with a task guide when you know what you want to build. Each task guide
explains what the feature does, prerequisites, how it works, a complete request,
the response, final status, and common failure modes.

<CardGroup cols={2}>
  <Card title="Send a WhatsApp message" icon="whatsapp" href="/en/api-reference/guides/whatsapp-platform/send-whatsapp-message">
    Choose between queued and direct sending.
  </Card>

  <Card title="Send an SMS" icon="comment-sms" href="/en/api-reference/guides/messaging/send-sms">
    Send text messages and track delivery.
  </Card>

  <Card title="Send an email" icon="envelope" href="/en/api-reference/guides/messaging/send-email">
    Send HTML or plain-text email.
  </Card>

  <Card title="Handle inbound messages" icon="inbox" href="/en/api-reference/guides/whatsapp-platform/handle-whatsapp-inbound-messages">
    Receive messages, mark them as read, and show typing indicators.
  </Card>

  <Card title="Send a voice code" icon="volume-high" href="/en/api-reference/guides/messaging/send-voice-code">
    Deliver a verification code through an automated call.
  </Card>
</CardGroup>

## Build on WhatsApp

<CardGroup cols={2}>
  <Card title="Business Accounts" icon="building" href="/en/api-reference/guides/whatsapp-platform/manage-whatsapp-business-accounts">
    Inspect connected WABAs, verification, restrictions, and messaging limits.
  </Card>

  <Card title="Phone numbers" icon="phone" href="/en/api-reference/guides/whatsapp-platform/manage-whatsapp-phone-numbers">
    Register senders and manage profiles, commerce, and calling settings.
  </Card>

  <Card title="WhatsApp message pricing" icon="receipt" href="/en/api-reference/guides/whatsapp-platform/whatsapp-message-pricing-integration-guide">
    Understand pricing fields, charging rules, and when message prices become final.
  </Card>

  <Card title="Templates" icon="rectangle-list" href="/en/api-reference/guides/whatsapp-platform/manage-whatsapp-templates">
    Create and manage approved message structures.
  </Card>

  <Card title="Flows" icon="diagram-project" href="/en/api-reference/guides/whatsapp-platform/manage-whatsapp-flows">
    Build, preview, publish, and deprecate structured experiences.
  </Card>

  <Card title="Media" icon="image" href="/en/api-reference/guides/whatsapp-platform/upload-whatsapp-media">
    Upload reusable media for WhatsApp messages.
  </Card>

  <Card title="Calling" icon="phone-volume" href="/en/api-reference/guides/whatsapp-platform/manage-whatsapp-calls">
    Connect, accept, reject, and terminate calls.
  </Card>

  <Card title="Business-scoped user IDs" icon="user-tag" href="/en/api-reference/guides/whatsapp-platform/use-business-scoped-user-ids">
    Send messages and calls without relying on a user's phone number.
  </Card>
</CardGroup>

## Manage customer data

<CardGroup cols={2}>
  <Card title="Contacts" icon="address-card" href="/en/api-reference/guides/customer-data-and-operations/manage-contacts">
    Create and maintain customer profiles.
  </Card>

  <Card title="Custom Events" icon="bolt" href="/en/api-reference/guides/customer-data-and-operations/track-custom-events">
    Define and send customer activity events.
  </Card>

  <Card title="Unsubscribers" icon="user-slash" href="/en/api-reference/guides/customer-data-and-operations/manage-unsubscribers">
    Record and enforce channel opt-outs.
  </Card>

  <Card title="Balance" icon="wallet" href="/en/api-reference/guides/customer-data-and-operations/check-account-balance">
    Monitor available account funds and currency.
  </Card>
</CardGroup>

## Understand the API

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/en/api-reference/guides/api-fundamentals/authentication">
    Authenticate securely with an API key.
  </Card>

  <Card title="Errors" icon="triangle-exclamation" href="/en/api-reference/guides/api-fundamentals/handle-errors">
    Handle failures and retries safely.
  </Card>

  <Card title="Pagination" icon="list" href="/en/api-reference/guides/api-fundamentals/pagination">
    Iterate through list endpoints.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/en/api-reference/guides/api-fundamentals/configure-webhooks">
    Receive events from YCloud.
  </Card>
</CardGroup>

## Adapt a working example

<CardGroup cols={2}>
  <Card title="Annotated examples" icon="book-open" href="/en/api-reference/guides/examples/overview">
    Follow visual walkthroughs with instructions, requests, responses, and implementation notes.
  </Card>

  <Card title="WhatsApp template creation" icon="rectangle-list" href="/en/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples">
    Create template variants with screenshots and annotated request examples.
  </Card>

  <Card title="Webhook walkthroughs" icon="webhook" href="/en/api-reference/guides/examples/webhook-examples/overview">
    Review prerequisites, event behavior, and scenario-specific payloads.
  </Card>

  <Card title="All webhook payloads" icon="brackets-curly" href="/en/api-reference/guides/examples/webhook-examples/webhook-payload-examples">
    Explore every supported event type and named payload example.
  </Card>
</CardGroup>

## Move from guide to reference

Use a guide to understand behavior and integration choices. Use the API
Reference to inspect every request field, response field, and enum value. Use
webhook examples to test your event handler before production traffic arrives.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.