# YCloud Docs: Spanish Referencia de la API > YCloud product documentation, API reference, and webhook payload documentation. ## Referencia de la API ### Primeros pasos - [API de YCloud](https://docs.ycloud.com/es/api-reference/getting-started/ycloud-api.md): Cree flujos de trabajo de mensajería, verificación, contactos y eventos con las API de YCloud. - [Inicio rápido](https://docs.ycloud.com/es/api-reference/getting-started/quickstart.md): Autentícate con YCloud y realiza tu primera solicitud de API. - [Registro de cambios de la API](https://docs.ycloud.com/es/api-reference/getting-started/changelog.md): Sigue las adiciones a la API de YCloud, los cambios de compatibilidad y las actualizaciones de la documentación para desarrolladores. - [YCloud Developer Kit](https://docs.ycloud.com/es/api-reference/getting-started/ycloud-developer-kit.md): Crea integraciones de YCloud con habilidades de programación con IA para Codex, Claude Code y WorkBuddy. ### Guías - [Guías](https://docs.ycloud.com/es/api-reference/guides/overview.md): Guías prácticas para compilar con la API de YCloud. #### Fundamentos de la API - [Autenticación](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/authentication.md): Autentica las solicitudes de la API de YCloud con una clave de API. - [Gestionar errores](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/handle-errors.md): Comprende las respuestas de error de YCloud y reintenta solicitudes de forma segura. - [Límites de tasa](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/rate-limits.md): Consulta las cuotas de la API de YCloud, lee los encabezados de límite de tasa y reintenta solicitudes limitadas de forma segura. - [Paginación](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/pagination.md): Obtén conjuntos completos de resultados desde los endpoints de lista de YCloud. - [Control de versiones y compatibilidad de la API](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/versioning.md): Gestione cambios compatibles de la API, identificadores opacos, nuevos tipos de eventos y versiones de URI. - [Configurar webhooks](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/configure-webhooks.md): Recibe eventos de YCloud en tu endpoint HTTPS. - [Implementar un receptor de webhooks](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/implement-a-webhook-receiver.md): Crea un endpoint, verifica firmas, acepta eventos de forma duradera y gestiona los reintentos y la suspensión de webhooks. #### Plataforma de WhatsApp ##### Enviar y recibir - [Enviar un mensaje de WhatsApp](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/send-whatsapp-message.md): Envía mensajes de plantilla, de sesión y multimedia de WhatsApp con la API en cola o sincrónica. - [Código de error de WhatsApp](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/whatsapp-error-code.md): Consulta los códigos de error de mensajería de WhatsApp y resuelve los mensajes fallidos enviados a través de YCloud. - [Gestionar mensajes entrantes de WhatsApp](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/handle-whatsapp-inbound-messages.md): Reciba mensajes entrantes, márquelos como leídos y muestre un indicador de escritura. - [Subir archivos multimedia de WhatsApp](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/upload-whatsapp-media.md): Sube archivos multimedia y usa el ID de archivo multimedia devuelto en las solicitudes de mensajes de WhatsApp. - [Guía de integración de precios de mensajes de WhatsApp](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/whatsapp-message-pricing-integration-guide.md): Comprende los campos de precios de mensajes de WhatsApp, las reglas de cobro y la firmeza del precio en los webhooks de YCloud. - [Guía de integración de Max Price](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/max-price-integration-guide.md): Configura pujas en plantillas de marketing, ajusta multiplicadores de mensajes y añade, conserva o borra la configuración de Max Price. ##### Buenas prácticas - [Prácticas recomendadas para la API de mensajes de WhatsApp](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/whatsapp-messages-api-best-practices.md): Cree flujos de trabajo de envío de mensajes de WhatsApp fiables, conformes a la normativa y observables para producción. - [Mejores prácticas para Direct Send](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/best-practices/direct-send.md): Comprende Meta Direct Send, envía contenido de Utilidad a través de YCloud y utiliza la extensión de conversión de plantillas de YCloud. ##### Cuentas comerciales - [Gestionar cuentas de WhatsApp Business](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/manage-whatsapp-business-accounts.md): Obtenga las cuentas de WhatsApp Business conectadas e interprete su estado operativo. - [Administrar números de teléfono de WhatsApp](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/manage-whatsapp-phone-numbers.md): Registrar números de teléfono y administrar perfiles, comercio y ajustes de llamadas. - [Usa identificadores de usuario con ámbito empresarial (BSUID)](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/use-business-scoped-user-ids.md): Envía mensajes y llamadas de WhatsApp con BSUID, solicita números de teléfono, gestiona entradas de la libreta de contactos de Meta y procesa campos de webhook de BSUID. ##### Plantillas y flujos - [Gestionar plantillas de WhatsApp](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/manage-whatsapp-templates.md): Crea, versiona, revisa, publica y retira plantillas de mensaje de WhatsApp de forma segura. - [Idiomas admitidos para plantillas de WhatsApp](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/supported-whatsapp-template-languages.md): Elige un código de idioma admitido por Meta cuando crees, gestiones o envíes una plantilla de WhatsApp. - [Gestionar WhatsApp Flows](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/manage-whatsapp-flows.md): Crea, valida, previsualiza, publica y descontinúa experiencias estructuradas de WhatsApp. - [Implementar un endpoint de WhatsApp Flow](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/implement-a-whatsapp-flow-endpoint.md): Gestiona health checks de Flow, notificaciones de errores, intercambio de datos, navegación y finalización a través de YCloud. ##### Llamadas y grupos - [Gestionar llamadas de WhatsApp](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/manage-whatsapp-calls.md): Configura WhatsApp Calling, gestiona la señalización de llamadas entrantes y salientes, procesa eventos de llamadas y descarga grabaciones o transcripciones. - [Gestionar grupos de WhatsApp](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/manage-whatsapp-groups.md): Aprende a crear grupos de WhatsApp solo por invitación, invitar a personas, revisar solicitudes de unión y gestionar la configuración de los grupos. #### Meta Business Agent - [Información general de Meta Business Agent](https://docs.ycloud.com/es/documentation/meta-business-agent/overview.md): Crea y opera un agente de IA alojado en Meta para un número de teléfono de WhatsApp Business mediante las API de YCloud. - [Preparar y comprobar la elegibilidad](https://docs.ycloud.com/es/documentation/meta-business-agent/prepare-and-check-eligibility.md): Confirme los requisitos previos de la empresa y compruebe si un número de teléfono de WhatsApp Business puede usar Meta Business Agent. - [Incorporación y configuración](https://docs.ycloud.com/es/documentation/meta-business-agent/onboard-and-configure.md): Crea un Meta Business Agent y configura sus ajustes, conocimientos, habilidades, conectores y herramientas. - [Probar y evaluar](https://docs.ycloud.com/es/documentation/meta-business-agent/test-and-evaluate.md): Valide escenarios de un solo turno, de múltiples turnos, de transferencia, de herramientas y de negocios antes de habilitar el lanzamiento completo. - [Implementa de forma segura](https://docs.ycloud.com/es/documentation/meta-business-agent/roll-out-safely.md): Habilita Meta Business Agent por fases, verifica cada cambio de configuración y mantén lista una solicitud de reversión probada. - [Operar y solucionar problemas](https://docs.ycloud.com/es/documentation/meta-business-agent/operate-and-troubleshoot.md): Controla los hilos de conversación, procesa eventos, inspecciona registros, gestiona errores y retira un Meta Business Agent de forma segura. #### Datos de clientes y operaciones - [Consultar saldo de la cuenta](https://docs.ycloud.com/es/api-reference/guides/customer-data-and-operations/check-account-balance.md): Obtén el saldo disponible y la moneda de la cuenta de YCloud. - [Gestionar contactos](https://docs.ycloud.com/es/api-reference/guides/customer-data-and-operations/manage-contacts.md): Crea y mantén perfiles de clientes utilizados en todos los flujos de trabajo de YCloud. - [Rastrear eventos personalizados](https://docs.ycloud.com/es/api-reference/guides/customer-data-and-operations/track-custom-events.md): Defina eventos de negocio y envíe la actividad de los clientes a YCloud. - [Gestionar bajas de suscripción](https://docs.ycloud.com/es/api-reference/guides/customer-data-and-operations/manage-unsubscribers.md): Registra y aplica las bajas (opt-outs) de clientes por canal. #### Ejemplos - [Resumen de ejemplos](https://docs.ycloud.com/es/api-reference/guides/examples/overview.md): Sigue guías paso a paso comentadas con capturas de pantalla, notas de implementación, solicitudes, respuestas y cargas útiles de Webhook. - [Ejemplos de Webhook](https://docs.ycloud.com/es/api-reference/webhook-reference/overview.md): Encuentra activadores, sintaxis del payload, parámetros y ejemplos para cada evento de webhook de YCloud. ##### Ejemplos de API - [Ejemplos de creación de plantillas de WhatsApp](https://docs.ycloud.com/es/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples.md): Crea plantillas de autenticación, utilidad, marketing, comercio, Flows y llamadas con ejemplos de solicitudes anotados. - [Ejemplos de mensajería de WhatsApp](https://docs.ycloud.com/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples.md): Envía mensajes de plantilla, multimedia, interactivos, de comercio, de Flow y de llamada con ejemplos de solicitud anotados. ### Endpoints #### Cuentas de WhatsApp Business - [List WABAs](https://docs.ycloud.com/api-reference/whatsapp-business-accounts/list-wabas.md): Returns a paginated list of WhatsApp business accounts you've registered. - [Retrieve a WABA](https://docs.ycloud.com/api-reference/whatsapp-business-accounts/retrieve-a-waba.md): Retrieves a WABA you've registered. - [Retrieve WABA automatic creative optimizations](https://docs.ycloud.com/api-reference/whatsapp-business-accounts/retrieve-waba-automatic-creative-optimizations.md): Retrieves current automatic creative optimization feature enrollment for a WhatsApp Business Account from Meta. - [Update WABA automatic creative optimizations](https://docs.ycloud.com/api-reference/whatsapp-business-accounts/update-waba-automatic-creative-optimizations.md): Partially updates automatic creative optimization feature enrollment for a WhatsApp Business Account. #### Mensajes entrantes de WhatsApp - [Mark message as read](https://docs.ycloud.com/api-reference/whatsapp-inbound-messages/mark-message-as-read.md): When you receive an inbound message from webhooks, you can use this endpoint to mark the message as read. Messages marked as read display two blue check marks alongside their timestamp. - [Mark message as read and display a typing indicator with a JSON response](https://docs.ycloud.com/api-reference/whatsapp-inbound-messages/mark-message-as-read-and-display-a-typing-indicator-with-a-json-response.md): Marks an inbound message as read and displays a typing indicator so the WhatsApp user knows you are preparing a response. Messages marked as read display two blue check marks alongside their timestamp. The typing indicator is dismissed once you respond, or after 25 seconds, whichever comes first. #### Archivos multimedia de WhatsApp - [Upload media](https://docs.ycloud.com/api-reference/whatsapp-media/upload-media.md): Uploads media that can later be sent in WhatsApp messages. This endpoint interfaces with Meta's WhatsApp Business API media endpoints. All media files sent through this endpoint are encrypted and persist for 30 days. #### Mensajes de WhatsApp - [Send a message directly](https://docs.ycloud.com/api-reference/whatsapp-messages/send-a-message-directly.md): Sends an outbound WhatsApp message directly. - [Enqueue a message](https://docs.ycloud.com/api-reference/whatsapp-messages/enqueue-a-message.md): Enqueues an outbound WhatsApp message for sending. - [Retrieve a message](https://docs.ycloud.com/api-reference/whatsapp-messages/retrieve-a-message.md): Retrieves a WhatsApp message you've previously sent. - [Submit a Direct Send message sample](https://docs.ycloud.com/api-reference/whatsapp-messages/submit-a-direct-send-message-sample.md): Submits one representative message sample to Meta and returns its detected category. We recommend submitting 3–4 samples that cover your utility use cases, one per request. This request does not send a message to a recipient. #### Mensajes de Messenger - [Send a Messenger text reply directly](https://docs.ycloud.com/api-reference/messenger-messages/send-a-messenger-text-reply-directly.md): Use your connected Facebook Page to send a one-to-one text reply. Meta determines reply eligibility; YCloud does not precheck the messaging window. Use a Tenant API Key. Developer App API Keys are not supported. - [Retrieve an outbound message by its YCloud ID](https://docs.ycloud.com/api-reference/messenger-messages/retrieve-an-outbound-message-by-its-ycloud-id.md): Retrieves a locally stored outbound record scoped by authenticated tenant and from. Does not query Meta or require the Page to remain connected. There is no inbound detail lookup or public message-history list in this phase. - [Retrieve an outbound message by its Meta message ID](https://docs.ycloud.com/api-reference/messenger-messages/retrieve-an-outbound-message-by-its-meta-message-id.md): The opaque Meta ID is a query parameter to avoid path-segment encoding problems. Use the YCloud message ID to retrieve records without a confirmed Meta ID. Only locally stored outbound messages are available. #### Usuarios bloqueados de WhatsApp - [Block users](https://docs.ycloud.com/api-reference/whatsapp-blocked-users/block-users.md): Blocks users from sending messages to the specified WhatsApp business phone number. You must have management permissions for this business phone number. YCloud synchronizes the operation with Meta's WhatsApp platform. - [Unblock users](https://docs.ycloud.com/api-reference/whatsapp-blocked-users/unblock-users.md): Removes users from the blocklist so they can send messages to the specified WhatsApp business phone number again. You must have management permissions for this business phone number. YCloud synchronizes the operation with Meta's WhatsApp platform. - [List blocked users](https://docs.ycloud.com/api-reference/whatsapp-blocked-users/list-blocked-users.md): Lists blocked users for the specified WhatsApp business phone number. You must have management permissions for this business phone number. #### Grupos de WhatsApp - [Create a group](https://docs.ycloud.com/api-reference/whatsapp-groups/create-a-group.md): Creates a WhatsApp group for the specified business phone number. - [List groups](https://docs.ycloud.com/api-reference/whatsapp-groups/list-groups.md): Returns a cursor-paginated list of active WhatsApp groups. - [Retrieve a group](https://docs.ycloud.com/api-reference/whatsapp-groups/retrieve-a-group.md): Retrieves a WhatsApp group. - [Delete a group](https://docs.ycloud.com/api-reference/whatsapp-groups/delete-a-group.md): Deletes a WhatsApp group. - [Retrieve a group invite link](https://docs.ycloud.com/api-reference/whatsapp-groups/retrieve-a-group-invite-link.md): Retrieves the invite link for a WhatsApp group. - [Reset a group invite link](https://docs.ycloud.com/api-reference/whatsapp-groups/reset-a-group-invite-link.md): Resets and returns the invite link for a WhatsApp group. - [Send a group invite link message](https://docs.ycloud.com/api-reference/whatsapp-groups/send-a-group-invite-link-message.md): Sends a WhatsApp template message that contains the group invite link parameter. - [List group join requests](https://docs.ycloud.com/api-reference/whatsapp-groups/list-group-join-requests.md): Returns a cursor-paginated list of pending join requests for a WhatsApp group. - [Approve group join requests](https://docs.ycloud.com/api-reference/whatsapp-groups/approve-group-join-requests.md): Approves one or more pending join requests for a WhatsApp group. - [Reject group join requests](https://docs.ycloud.com/api-reference/whatsapp-groups/reject-group-join-requests.md): Rejects one or more pending join requests for a WhatsApp group. - [Remove group participants](https://docs.ycloud.com/api-reference/whatsapp-groups/remove-group-participants.md): Removes one or more participants from a WhatsApp group. - [Update group settings](https://docs.ycloud.com/api-reference/whatsapp-groups/update-group-settings.md): Updates a WhatsApp group's settings, such as subject or description. #### Llamadas de WhatsApp - [Connect a call](https://docs.ycloud.com/api-reference/whatsapp-calling/connect-a-call.md): Initiates a WhatsApp call connection. - [Pre-accept a call](https://docs.ycloud.com/api-reference/whatsapp-calling/pre-accept-a-call.md): Pre-accepts an inbound WhatsApp call. - [Accept a call](https://docs.ycloud.com/api-reference/whatsapp-calling/accept-a-call.md): Accepts an inbound WhatsApp call. - [Terminate a call](https://docs.ycloud.com/api-reference/whatsapp-calling/terminate-a-call.md): Terminates an active WhatsApp call. - [Reject a call](https://docs.ycloud.com/api-reference/whatsapp-calling/reject-a-call.md): Rejects an inbound WhatsApp call. - [Download call media](https://docs.ycloud.com/api-reference/whatsapp-calling/download-call-media.md): Downloads an available recording or transcription generated for an API-sourced WhatsApp call. #### Números de teléfono de WhatsApp - [List phone numbers](https://docs.ycloud.com/api-reference/whatsapp-phone-numbers/list-phone-numbers.md): Returns a paginated list of WhatsApp business phone numbers you've registered. - [Retrieve a phone number](https://docs.ycloud.com/api-reference/whatsapp-phone-numbers/retrieve-a-phone-number.md): Retrieves a WhatsApp business phone number you've registered. - [Retrieve a phone number profile](https://docs.ycloud.com/api-reference/whatsapp-phone-numbers/retrieve-a-phone-number-profile.md): Retrieves a WhatsApp business phone number's profile. Customers can view your business profile by clicking your business's name or number in a conversation thread. - [Update a phone number profile](https://docs.ycloud.com/api-reference/whatsapp-phone-numbers/update-a-phone-number-profile.md): Updates a WhatsApp business phone number profile. - [Update a phone number display name](https://docs.ycloud.com/api-reference/whatsapp-phone-numbers/update-a-phone-number-display-name.md): Updates a WhatsApp business phone number display name. - [Retrieve commerce settings](https://docs.ycloud.com/api-reference/whatsapp-phone-numbers/retrieve-commerce-settings.md): Retrieves a WhatsApp business phone number's commerce settings. - [Update commerce settings](https://docs.ycloud.com/api-reference/whatsapp-phone-numbers/update-commerce-settings.md): Updates a WhatsApp business phone number's commerce settings. Use this endpoint to enable or disable the shopping cart or the product catalog for a specific business phone number. - [Register a phone number](https://docs.ycloud.com/api-reference/whatsapp-phone-numbers/register-a-phone-number.md): Registers a WhatsApp business phone number. - [Retrieve phone number settings](https://docs.ycloud.com/api-reference/whatsapp-phone-numbers/retrieve-phone-number-settings.md): Retrieves phone number specific settings. - [Save phone number settings](https://docs.ycloud.com/api-reference/whatsapp-phone-numbers/save-phone-number-settings.md): Saves phone number specific settings. Send `calling`, `capture`, or both. When both are supplied, the service independently attempts both saves after shared authorization and phone-number validation. A failure in either branch does not prevent the other branch from being attempted. If either branch… - [Retrieve a phone number business username](https://docs.ycloud.com/api-reference/whatsapp-phone-numbers/retrieve-a-phone-number-business-username.md): Retrieves the Business Username state for a WhatsApp business phone number. The response reflects YCloud's latest known phone number state. If the phone number has no locally stored Business Username state, YCloud may sync the current username state from Meta before returning the response. - [Retrieve phone number business username suggestions](https://docs.ycloud.com/api-reference/whatsapp-phone-numbers/retrieve-phone-number-business-username-suggestions.md): Retrieves reserved Business Username suggestions for a WhatsApp business phone number. The response flattens Meta username suggestions into a string array. If no suggestions are available, `data` is an empty array. - [Update a phone number business username](https://docs.ycloud.com/api-reference/whatsapp-phone-numbers/update-a-phone-number-business-username.md): Requests a Business Username update for a WhatsApp business phone number. The requested username may require Meta review before it becomes active. If Meta accepts or reserves the request for review, the response status is usually `reserved`; `pending_review` is kept only as a legacy compatibility va… - [Delete a phone number business username](https://docs.ycloud.com/api-reference/whatsapp-phone-numbers/delete-a-phone-number-business-username.md): Deletes the active Business Username for a WhatsApp business phone number. This operation removes the currently active Business Username. It does not cancel or remove a reserved Business Username request. If a reserved request still exists after deletion, the returned `businessUsernameStatus` remain… - [Check a Meta contact book entry](https://docs.ycloud.com/api-reference/whatsapp-phone-numbers/check-a-meta-contact-book-entry.md): Checks whether Meta has a phone number entry for this standard BSUID in this business phone number contact book, without returning the phone number. Uses the same account API key, available WABA ownership and bound phone checks as DELETE. Parent BSUIDs are unsupported; Developer App API keys return… - [Delete a Meta contact book entry](https://docs.ycloud.com/api-reference/whatsapp-phone-numbers/delete-a-meta-contact-book-entry.md): Deletes the Meta contact book entry that associates a WhatsApp business phone number with a customer's WhatsApp Business-scoped user ID (BSUID). #### Plantillas de WhatsApp - [Create a template](https://docs.ycloud.com/api-reference/whatsapp-templates/create-a-template.md): Creates a WhatsApp template. - [List templates](https://docs.ycloud.com/api-reference/whatsapp-templates/list-templates.md): Returns a paginated list of WhatsApp templates you've previously created. - [Retrieve WhatsApp template analytics](https://docs.ycloud.com/api-reference/whatsapp-templates/retrieve-whatsapp-template-analytics.md): Returns daily YCloud message metrics and, when available, Meta Template Insights for one WhatsApp template. Authenticate with `X-API-Key`. `analyticsStatus` describes Meta Template Insights only; it does not describe YCloud metrics. Dates are interpreted in the WABA timezone, both boundaries are inc… - [Delete templates by name](https://docs.ycloud.com/api-reference/whatsapp-templates/delete-templates-by-name.md): Deletes WhatsApp templates by name. If that template name exists in multiple languages, all languages will be deleted. HTTP status `404` is returned if no templates are found for the specific name. - [Delete a template](https://docs.ycloud.com/api-reference/whatsapp-templates/delete-a-template.md): Deletes a WhatsApp template by name and language. - [Edit a template](https://docs.ycloud.com/api-reference/whatsapp-templates/edit-a-template.md): Edits a WhatsApp template by name and language. Editing a template replaces its old contents entirely, so include any components you wish to preserve as well as components you wish to update using the components parameter. - [Retrieve a template](https://docs.ycloud.com/api-reference/whatsapp-templates/retrieve-a-template.md): Retrieves a WhatsApp template by name and language. #### WhatsApp Flows - [Create a flow](https://docs.ycloud.com/api-reference/whatsapp-flows/create-a-flow.md): Creates a new WhatsApp Flow. New Flows are by default created in DRAFT state. You can create a new published Flow in single request by specifying flowJson and publish parameters. - [List flows](https://docs.ycloud.com/api-reference/whatsapp-flows/list-flows.md): Returns a list of WhatsApp Flows under a WhatsApp Business Account (WABA). - [Update flow metadata](https://docs.ycloud.com/api-reference/whatsapp-flows/update-flow-metadata.md): Updates a WhatsApp Flow's metadata (name or categories). - [Update flow structure](https://docs.ycloud.com/api-reference/whatsapp-flows/update-flow-structure.md): Updates a WhatsApp Flow's structure. Note that the file must be attached as form-data. - [Delete a flow](https://docs.ycloud.com/api-reference/whatsapp-flows/delete-a-flow.md): Deletes a WhatsApp Flow. Only Flows in DRAFT status can be deleted. - [Retrieve a flow](https://docs.ycloud.com/api-reference/whatsapp-flows/retrieve-a-flow.md): Retrieves a WhatsApp Flow's details. - [Publish a flow](https://docs.ycloud.com/api-reference/whatsapp-flows/publish-a-flow.md): Updates the status of the Flow to "PUBLISHED". You can either edit this flow in the future and turn it back to the "DRAFT" state, or create a new flow by specifying the existing Flow ID as the cloneFlowId parameter. - [Deprecate a flow](https://docs.ycloud.com/api-reference/whatsapp-flows/deprecate-a-flow.md): Marks a published Flow as deprecated. Once a Flow is published, it cannot be modified or deleted, but can be marked as deprecated. - [generate a web preview URL with this flow.](https://docs.ycloud.com/api-reference/whatsapp-flows/generate-a-web-preview-url-with-this-flow.md): In order to visualize the Flows created, you can generate a web preview URL with this request. **The preview URL is public and can be shared with different stakeholders to visualize the Flow.**. #### Saldo - [Retrieve balance](https://docs.ycloud.com/api-reference/balance/retrieve-balance.md): Retrieves the current account balance. #### Contactos - [Create a contact](https://docs.ycloud.com/api-reference/contacts/create-a-contact.md): Creates a contact. - [List contacts](https://docs.ycloud.com/api-reference/contacts/list-contacts.md): Returns a paginated list of contacts. - [Retrieve a contact](https://docs.ycloud.com/api-reference/contacts/retrieve-a-contact.md): Retrieves a contact. - [List contact notes](https://docs.ycloud.com/api-reference/contacts/list-contact-notes.md): Returns all notes for a contact, ordered by creation time descending. The `{contactIdentifier}` path parameter supports a contact ID, a phone number in E.164 format starting with `+`, or a Meta username without the leading `@`. Ambiguous numeric values are resolved as Meta usernames first and fall b… - [Create a contact note](https://docs.ycloud.com/api-reference/contacts/create-a-contact-note.md): Creates one note for the contact and returns the created note. Leading and trailing whitespace is removed before storage. This operation does not use a client idempotency key; repeating the request creates another note with a different ID. - [Update a contact note](https://docs.ycloud.com/api-reference/contacts/update-a-contact-note.md): Updates one note in the current tenant by note ID and returns the updated note. Repeating the same request leaves the stored content unchanged, but an accepted update may still produce another `contact.note.updated` event. - [Delete a contact note](https://docs.ycloud.com/api-reference/contacts/delete-a-contact-note.md): Deletes one note in the current tenant by note ID and returns its snapshot before deletion. Deleting the same note again returns `404`; the operation does not use a client idempotency key. - [Update a contact](https://docs.ycloud.com/api-reference/contacts/update-a-contact.md): Updates a contact. If every supplied persisted contact field already has the requested value, the contact is not updated and no `contact.attributes_changed` event is emitted. Note mutations in the same request are still applied. - [Delete a contact](https://docs.ycloud.com/api-reference/contacts/delete-a-contact.md): Deletes a contact. - [List contact attributes](https://docs.ycloud.com/api-reference/contacts/list-contact-attributes.md): Returns a list of all available contact attributes and their configurations. #### Eventos personalizados - [Create an event definition](https://docs.ycloud.com/api-reference/custom-events/create-an-event-definition.md): Creates a custom event definition. - [Retrieve an event definition](https://docs.ycloud.com/api-reference/custom-events/retrieve-an-event-definition.md): Retrieves a custom event definition you previously created. - [Update an event definition](https://docs.ycloud.com/api-reference/custom-events/update-an-event-definition.md): Updates an event definition's label and description. - [Create an event property definition](https://docs.ycloud.com/api-reference/custom-events/create-an-event-property-definition.md): Defines a new property for the event definition. - [Update an event property definition](https://docs.ycloud.com/api-reference/custom-events/update-an-event-property-definition.md): Updates an event property definition's label and description. - [Delete an event property definition](https://docs.ycloud.com/api-reference/custom-events/delete-an-event-property-definition.md): Deletes a property of the event definition. - [Send an event](https://docs.ycloud.com/api-reference/custom-events/send-an-event.md): Sends an occurrence of a previously defined custom event. For contact events, identify the contact using one of a contact ID, phone number, or Meta username. #### Correos electrónicos - [Send an email](https://docs.ycloud.com/api-reference/emails/send-an-email.md): Sends an outbound email message. #### SMS - [Send an SMS](https://docs.ycloud.com/api-reference/sms/send-an-sms.md): Sends an outbound text message. - [List SMS records](https://docs.ycloud.com/api-reference/sms/list-sms-records.md): Returns a paginated list of SMS messages you've previously sent. #### Usuarios dados de baja - [Create an unsubscriber](https://docs.ycloud.com/api-reference/unsubscribers/create-an-unsubscriber.md): Creates an unsubscriber. An unsubscriber is a configuration item representing that customers opt out of receiving messages from your business. **A customer and a channel form a unique identifier for an unsubscriber.** - [List unsubscribers](https://docs.ycloud.com/api-reference/unsubscribers/list-unsubscribers.md): Returns a paginated list of unsubscribers. - [List all unsubscribers by customer](https://docs.ycloud.com/api-reference/unsubscribers/list-all-unsubscribers-by-customer.md): Returns all unsubscribers for the specified customer. - [Retrieve an unsubscriber](https://docs.ycloud.com/api-reference/unsubscribers/retrieve-an-unsubscriber.md): Retrieves the unsubscriber for the specified customer and channel. - [Delete an unsubscriber](https://docs.ycloud.com/api-reference/unsubscribers/delete-an-unsubscriber.md): Deletes the unsubscriber for the specified customer and channel. #### Verificación - [Start a verification](https://docs.ycloud.com/api-reference/verify/start-a-verification.md): Starts a verification by sending an SMS, voice, or email message to the recipient. This verification is charged once the message is sent successfully. - [Check a verification](https://docs.ycloud.com/api-reference/verify/check-a-verification.md): Checks a verification with a phone number, an email address, or a verification ID. A `pending` verification status changes to `approved` once you receive a response with the `valid` parameter is `true`. An approved verification cannot be checked anymore. #### Voces - [Send a voice code](https://docs.ycloud.com/api-reference/voices/send-a-voice-code.md): Sends an outbound voice call verification code. - [List voice records](https://docs.ycloud.com/api-reference/voices/list-voice-records.md): Returns a paginated list of voice calls you've previously sent. #### Endpoints de Webhook - [Create a webhook endpoint](https://docs.ycloud.com/api-reference/webhook-endpoints/create-a-webhook-endpoint.md): Creates a webhook endpoint listening for specific events. - [List webhook endpoints](https://docs.ycloud.com/api-reference/webhook-endpoints/list-webhook-endpoints.md): Returns a paginated list of webhook endpoints. - [Retrieve a webhook endpoint](https://docs.ycloud.com/api-reference/webhook-endpoints/retrieve-a-webhook-endpoint.md): Retrieves the webhook endpoint with the given ID. - [Update a webhook endpoint](https://docs.ycloud.com/api-reference/webhook-endpoints/update-a-webhook-endpoint.md): Updates a webhook endpoint, such as url, events, status. - [Delete a webhook endpoint](https://docs.ycloud.com/api-reference/webhook-endpoints/delete-a-webhook-endpoint.md): Deletes a webhook endpoint. - [Rotate a webhook endpoint secret](https://docs.ycloud.com/api-reference/webhook-endpoints/rotate-a-webhook-endpoint-secret.md): Generates a new secret for a webhook endpoint. #### Meta Business Agent - [Información general sobre Meta Business Agent](https://docs.ycloud.com/es/api-reference/meta-business-agents/overview.md): Explora los recursos REST de YCloud para la integración, configuración, prueba, lanzamiento y operación de Meta Business Agent. ##### Configurar ###### Conocimiento del agente: información de la empresa - [Get Business Info](https://docs.ycloud.com/api-reference/meta-business-agents/get-business-info.md): Retrieves the business information used by the agent when answering customers, including policies, purchase and shipping details, the business description, and contact information. - [Replace Business Info](https://docs.ycloud.com/api-reference/meta-business-agents/replace-business-info.md): Creates or fully replaces the phone number's business information knowledge. Values supplied in the request overwrite the existing business information. - [Delete Business Info](https://docs.ycloud.com/api-reference/meta-business-agents/delete-business-info.md): Resets the agent's business information to Meta's default empty values and returns the resulting business information object. ###### Conocimiento del agente: preguntas frecuentes - [List Faqs](https://docs.ycloud.com/api-reference/meta-business-agents/list-faqs.md): Lists all FAQ question-and-answer entries currently available to the agent as knowledge. - [Create Faq](https://docs.ycloud.com/api-reference/meta-business-agents/create-faq.md): Creates a question-and-answer entry in the agent knowledge base and returns the created FAQ. - [Get Faq](https://docs.ycloud.com/api-reference/meta-business-agents/get-faq.md): Retrieves the FAQ knowledge entry identified by `faqId`. - [Update Faq](https://docs.ycloud.com/api-reference/meta-business-agents/update-faq.md): Send both `question` and `answer` to update the FAQ. You can also include `metadata`. The response may contain a new `id`. Use the returned ID for subsequent reads, updates, and deletes. If the ID changes, `created_at` resets to the update time. A timeout or HTTP `502` response does not necessarily… - [Delete Faq](https://docs.ycloud.com/api-reference/meta-business-agents/delete-faq.md): Deletes the FAQ identified by `faqId`. Returns HTTP `204` when deletion succeeds or Meta explicitly reports that the FAQ does not exist. Other `404` errors remain errors. ###### Conocimiento del agente: archivos - [List Files](https://docs.ycloud.com/api-reference/meta-business-agents/list-files.md): Lists all uploaded file-based knowledge sources for the agent, including the metadata and processing state returned by Meta. - [Upload File](https://docs.ycloud.com/api-reference/meta-business-agents/upload-file.md): Streams the multipart `file` upload to Meta and adds it as a file-based knowledge source for the agent. - [Get File](https://docs.ycloud.com/api-reference/meta-business-agents/get-file.md): Retrieves the metadata and processing state of the knowledge file identified by `fileId`. - [Delete File](https://docs.ycloud.com/api-reference/meta-business-agents/delete-file.md): Deletes the uploaded file identified by `fileId` from the agent knowledge base. ###### Conocimiento del agente: sitios web - [List Websites](https://docs.ycloud.com/api-reference/meta-business-agents/list-websites.md): Lists the website URLs configured for Meta to crawl and ingest into the agent knowledge base, including each crawl entry's current state. - [Create Website](https://docs.ycloud.com/api-reference/meta-business-agents/create-website.md): Adds a website URL for Meta to crawl and ingest into the agent knowledge base and returns the created crawl entry. - [Get Website](https://docs.ycloud.com/api-reference/meta-business-agents/get-website.md): Retrieves the website knowledge entry identified by `websiteId`, including its URL and crawl status information. - [Update Website](https://docs.ycloud.com/api-reference/meta-business-agents/update-website.md): Updates the URL and optional crawl scope of the website identified by `websiteId`. The response may contain a new `id`. Use the returned ID for subsequent reads, updates, and deletes. Do not automatically retry an update whose outcome is uncertain. - [Delete Website](https://docs.ycloud.com/api-reference/meta-business-agents/delete-website.md): Removes the website crawl entry identified by `websiteId` from the agent knowledge base. ###### Habilidades del agente - [List Skills](https://docs.ycloud.com/api-reference/meta-business-agents/list-skills.md): Lists the agent's skills, which define behavioral instructions, tone, and response patterns. Pass `agent_id` to target a specific settings object. - [Create Skill](https://docs.ycloud.com/api-reference/meta-business-agents/create-skill.md): Creates a behavioral skill for the agent from the supplied title, description, and instruction text. - [Get Skill](https://docs.ycloud.com/api-reference/meta-business-agents/get-skill.md): Retrieves the behavioral skill identified by `skillId`. - [Update Skill](https://docs.ycloud.com/api-reference/meta-business-agents/update-skill.md): Updates the supplied title, description, or instruction text of the skill identified by `skillId` and returns the updated skill. - [Delete Skill](https://docs.ycloud.com/api-reference/meta-business-agents/delete-skill.md): Deletes the behavioral skill identified by `skillId` from the agent configuration. ###### Habilidades de interfaz de usuario - [List UI Skills](https://docs.ycloud.com/api-reference/meta-business-agents/list-ui-skills.md): Lists the rich WhatsApp UI components that the agent can select during a conversation. Continue pagination while `paging.next` is present. - [Create UI Skill](https://docs.ycloud.com/api-reference/meta-business-agents/create-ui-skill.md): Creates a UI Skill. `flow_id` is required only when `component_type` is `flow` and must be omitted for every other component type. - [Get UI Skill](https://docs.ycloud.com/api-reference/meta-business-agents/get-ui-skill.md): Retrieves the UI Skill identified by `skillId`. - [Update UI Skill](https://docs.ycloud.com/api-reference/meta-business-agents/update-ui-skill.md): Updates the title, status, and instruction of the UI Skill identified by `skillId`. Component type and Flow association cannot be changed by this operation. - [Delete UI Skill](https://docs.ycloud.com/api-reference/meta-business-agents/delete-ui-skill.md): Deletes the UI Skill identified by `skillId`. ###### Herramientas de conectores - [List Connector Tools](https://docs.ycloud.com/api-reference/meta-business-agents/list-connector-tools.md): Lists the tool operations defined under `connectorId` that the agent can use to call the external service. - [Create Connector Tool](https://docs.ycloud.com/api-reference/meta-business-agents/create-connector-tool.md): Creates a tool under `connectorId`, including its agent-facing description, outbound request definition, and optional user-auth extraction configuration. transformation_spec is optional: omit it to preserve an existing transformation on update, send null to delete it, or send an object to set it. - [Get Connector Tool](https://docs.ycloud.com/api-reference/meta-business-agents/get-connector-tool.md): Retrieves the connector tool identified by `toolId`, including its outbound request and user-auth definitions. - [Update Connector Tool](https://docs.ycloud.com/api-reference/meta-business-agents/update-connector-tool.md): Updates the name, description, outbound request definition, and user-auth configuration of the connector tool identified by `toolId`. transformation_spec is optional: omit it to preserve an existing transformation on update, send null to delete it, or send an object to set it. - [Delete Connector Tool](https://docs.ycloud.com/api-reference/meta-business-agents/delete-connector-tool.md): Deletes the tool identified by `toolId` from `connectorId`. - [Run Connector Tool](https://docs.ycloud.com/api-reference/meta-business-agents/run-connector-tool.md): Executes the connector tool identified by `toolId` with the supplied `input` and returns the upstream API result exposed by Meta. ###### Conectores - [List Connectors](https://docs.ycloud.com/api-reference/meta-business-agents/list-connectors.md): Lists the external API connectors configured for the agent, including their endpoint and authentication definitions. - [Create Connector](https://docs.ycloud.com/api-reference/meta-business-agents/create-connector.md): Creates an external API connector with its name, description, base URL, authentication type, and optional user-auth or certificate configuration. For MCP, base_url is the remote MCP server address and authentication uses the existing auth fields. Creating a connector does not guarantee discovered to… - [Get Connector](https://docs.ycloud.com/api-reference/meta-business-agents/get-connector.md): Retrieves the external API connector identified by `connectorId`. - [Update Connector](https://docs.ycloud.com/api-reference/meta-business-agents/update-connector.md): Updates the connector definition identified by `connectorId`, including its descriptive, endpoint, authentication, and certificate requirement fields. connector_protocol cannot be changed after creation. - [Refresh MCP Connector Tools](https://docs.ycloud.com/api-reference/meta-business-agents/refresh-mcp-connector-tools.md): Triggers Meta to rediscover the MCP tools exposed by this connector. The request has no body. A successful HTTP 200 returns the current Connector; inspect mcp_tool_sync.status because remote discovery or provisioning failure can still return HTTP 200 with status ERROR. This operation has no idempote… - [Delete Connector](https://docs.ycloud.com/api-reference/meta-business-agents/delete-connector.md): Deletes the external API connector identified by `connectorId` from the agent configuration. - [Upsert Connector Certificate](https://docs.ycloud.com/api-reference/meta-business-agents/upsert-connector-certificate.md): Uploads or rotates the mTLS client certificate, private key, and optional CA certificate for `connectorId`, then returns the updated connector. - [Upsert Connector Api Key](https://docs.ycloud.com/api-reference/meta-business-agents/upsert-connector-api-key.md): Sets or rotates the API key credentials for `connectorId`. Existing API key credentials are replaced, and the updated connector is returned. - [Upsert Connector O Auth](https://docs.ycloud.com/api-reference/meta-business-agents/upsert-connector-o-auth.md): Sets or rotates the OAuth 2.0 client credentials for `connectorId`. Existing OAuth credentials are replaced, and the updated connector is returned. - [List Connector Logs](https://docs.ycloud.com/api-reference/meta-business-agents/list-connector-logs.md): Retrieves third-party connector error logs for the requested time and tool filters. It can return individual entries, aggregated failure patterns, and optional success-rate or latency statistics; Meta limits the query window and retention to seven days. ##### Eliminar agente - [Delete Agent](https://docs.ycloud.com/api-reference/meta-business-agents/delete-agent.md): Removes the Meta Business Agent from the WhatsApp phone number and deletes its agent configuration. If this is the account's last agent, Meta also disconnects the integration; `deleted_agent_id` is null when there was nothing to remove. ##### Incorporación ###### Lista de permitidos del agente - [List Allowlist](https://docs.ycloud.com/api-reference/meta-business-agents/list-allowlist.md): Lists allowlist entries that may receive agent replies when `ai_audience` is set to `ALLOWLISTED_ONLY`. Identity fields may be absent. - [Create Allowlist Entry](https://docs.ycloud.com/api-reference/meta-business-agents/create-allowlist-entry.md): Adds exactly one explicitly supplied WhatsApp identity: consumer_phone_number or consumer_bsuid. This public API does not look up a BSUID from a phone number. Phone and BSUID entries have distinct IDs and each counts toward the shared limit of 20. - [Delete Allowlist Entry](https://docs.ycloud.com/api-reference/meta-business-agents/delete-allowlist-entry.md): Deletes only the entry identified by entryId. Other phone or BSUID entries remain unchanged. ###### Elegibilidad del agente - [Check Eligibility](https://docs.ycloud.com/api-reference/meta-business-agents/check-eligibility.md): Checks whether the WhatsApp Business Phone Number identified by `entityId` is eligible to use Meta Business Agent and returns Meta's eligibility result. ###### Incorporación de agentes - [Onboard Agent](https://docs.ycloud.com/api-reference/meta-business-agents/onboard-agent.md): Starts onboarding for the phone number, creates the required agent resources, and schedules asynchronous data preparation. The optional request body may provide `catalog_id`; onboarding alone does not enable customer replies. ###### Configuración del agente - [Get Settings](https://docs.ycloud.com/api-reference/meta-business-agents/get-settings.md): Returns the current agent settings as a list. Pass `agent_id` to target a specific settings object; when it is omitted, Meta returns the latest settings for the channel. - [Replace Settings](https://docs.ycloud.com/api-reference/meta-business-agents/replace-settings.md): Creates or updates rollout, handoff, follow-up, audience, and response-policy settings for the agent. YCloud omits null fields before calling Meta. Omitting `never_say_phrases` preserves the current list, an empty list clears it, and a non-empty list fully replaces it. ###### Presupuestos del agente - [Get Budgets](https://docs.ycloud.com/api-reference/meta-business-agents/get-budgets.md): Returns the complete Budget collection for the Business Manager associated with the WhatsApp Business Phone Number ID. An empty collection means usage is unlimited. - [Replace Budgets](https://docs.ycloud.com/api-reference/meta-business-agents/replace-budgets.md): Replaces the complete Budget collection. Include every `token` and `ai_turn` entry that should remain. Send an empty collection to remove all limits. ##### Operar ###### Evaluación del agente - [List Eval Cases](https://docs.ycloud.com/api-reference/meta-business-agents/list-eval-cases.md): Lists the evaluation scenario configurations available for the agent, including their scenario, categories, turn limit, and success criteria. - [Get Eval Summary](https://docs.ycloud.com/api-reference/meta-business-agents/get-eval-summary.md): Retrieves aggregated evaluation insight reports for the comma-separated `summary_ids` supplied in the query string. - [Get Eval Details](https://docs.ycloud.com/api-reference/meta-business-agents/get-eval-details.md): Retrieves per-conversation evaluation results for the comma-separated `eval_ids` supplied in the query string. - [Get Eval Run Status](https://docs.ycloud.com/api-reference/meta-business-agents/get-eval-run-status.md): Polls the evaluation job identified by `jobId` and returns its status, progress, completed result, or error information. - [Submit Eval Run](https://docs.ycloud.com/api-reference/meta-business-agents/submit-eval-run.md): Starts an asynchronous evaluation job for the supplied Meta-native `eval_case_ids` value and returns its `job_id` and initial status. ###### Evento del agente - [Submit Agent Event](https://docs.ycloud.com/api-reference/meta-business-agents/submit-agent-event.md): Submits a business event for a consumer and enqueues it for asynchronous agent processing. The immediate response contains `status` and `agent_event_id` for later polling. - [Get Agent Event Status](https://docs.ycloud.com/api-reference/meta-business-agents/get-agent-event-status.md): Retrieves the current processing status, timestamps, and any error or skip reason for the event identified by `agentEventId`. ###### Prueba del agente - [Test Agent](https://docs.ycloud.com/api-reference/meta-business-agents/test-agent.md): Sends `user_msg` through the full agent pipeline and returns a synchronous test response without requiring a real consumer number. Reuse the optional `conversation_id` to continue a multi-turn test. ###### Turnos de conversación - [Get Conversation Turns](https://docs.ycloud.com/api-reference/meta-business-agents/get-conversation-turns.md): Returns conversation turns for one WhatsApp user. Timestamp boundaries are inclusive Unix epoch milliseconds. Continue pagination while `paging.next` is present, including when the current `data` array is empty. ###### Control de hilos (Cloud API) - [Control Thread](https://docs.ycloud.com/api-reference/meta-business-agents/control-thread.md): Passes, releases, or takes control of a consumer thread. YCloud resolves the tenant and Meta credential. ### Webhook reference #### Messenger - [messenger.inbound_message.received](https://docs.ycloud.com/es/api-reference/webhook-reference/messenger-inbound-message-received.md): Se produce cuando se recibe un mensaje de texto ordinario de Messenger de un cliente. - [messenger.inbound_message.updated](https://docs.ycloud.com/es/api-reference/webhook-reference/messenger-inbound-message-updated.md): Se produce cuando un cliente edita un mensaje de texto entrante de Messenger guardado. - [messenger.message.updated](https://docs.ycloud.com/es/api-reference/webhook-reference/messenger-message-updated.md): Ocurre cuando está disponible una instantánea guardada de un mensaje saliente ordinario de Messenger, incluidos los resultados del envío y los recibos asociados. - [messenger.message_reaction.updated](https://docs.ycloud.com/es/api-reference/webhook-reference/messenger-message-reaction-updated.md): Se produce cuando un cliente reacciona a un mensaje de Messenger o elimina su reacción. #### WhatsApp messages - [whatsapp.inbound_message.received](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-inbound-message-received.md): Se produce cuando se recibe un mensaje entrante de WhatsApp. - [whatsapp.message.updated](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-message-updated.md): Se produce cuando se actualiza el estado de un mensaje saliente de WhatsApp y el estado cambia a `sent`, `failed`, `delivered` o `read`. - [whatsapp.user.preferences](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-user-preferences.md): Se produce cuando un usuario de WhatsApp deja de recibir mensajes de marketing o reanuda su recepción. #### WhatsApp templates - [whatsapp.template.category_updated](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-template-category-updated.md): Se produce cuando se actualiza la categoría de una plantilla de WhatsApp. - [whatsapp.template.correct_category_detection](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-template-correct-category-detection.md): Se produce cuando Meta detecta contenido que no es de utilidad en Utility Direct Send. Suscríbete mediante la API de endpoint de webhook. - [whatsapp.template.quality_updated](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-template-quality-updated.md): Se produce cuando se actualiza la calificación de calidad de una plantilla de WhatsApp. - [whatsapp.template.reviewed](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-template-reviewed.md): Se produce cuando una plantilla de WhatsApp recibe una actualización de revisión o del ciclo de vida, lo que incluye su aprobación, rechazo, pausa, desactivación, archivado y desarchivado. #### WhatsApp accounts - [whatsapp.business_account.deleted](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-business-account-deleted.md): Se produce cuando se elimina una cuenta de WhatsApp Business. - [whatsapp.business_account.reviewed](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-business-account-reviewed.md): Se produce cuando se ha revisado una cuenta de WhatsApp Business. - [whatsapp.business_account.updated](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-business-account-updated.md): Ocurre cuando se produce una infracción de políticas, se suspende la cuenta de WhatsApp Business y más. #### WhatsApp phone numbers - [whatsapp.phone_number.deleted](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-phone-number-deleted.md): Se produce cuando se elimina un número de teléfono comercial de WhatsApp. - [whatsapp.phone_number.name_updated](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-phone-number-name-updated.md): Se produce cuando se aprueba o rechaza el nombre de un número de teléfono comercial de WhatsApp. - [whatsapp.phone_number.quality_updated](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-phone-number-quality-updated.md): Se produce cuando se actualiza la calidad, el límite de mensajería o el estado de conexión de la cuenta de un número de teléfono comercial de WhatsApp. - [whatsapp.phone_number.business_username_updated](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-phone-number-business-username-updated.md): Se produce cuando se actualiza el nombre de usuario de empresa (Business Username) de un número de teléfono comercial de WhatsApp. #### WhatsApp Business App - [whatsapp.smb.history](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-smb-history.md): Se produce cuando se sincroniza el historial de mensajes de la aplicación WhatsApp Business. - [whatsapp.smb.message.created](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-smb-message-created.md): Se produce cuando se envía un mensaje desde la WhatsApp Business App. - [whatsapp.smb.message.echoes](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-smb-message-echoes.md): Se produce cuando un mensaje enviado desde la WhatsApp Business App se sincroniza como un eco. #### WhatsApp Agents - [whatsapp.echo_message.created](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-echo-message-created.md): Se produce cuando se registra un mensaje de eco saliente para un agente de la API REST pública. - [whatsapp.echo_message.updated](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-echo-message-updated.md): Se produce cuando se recibe un estado de eco saliente para un Public REST API Agent; también se pueden entregar estados tardíos de menor prioridad. - [whatsapp.meta_business_agent.handover.updated](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-meta-business-agent-handover-updated.md): Ocurre cuando una devolución de llamada de traspaso admitida transfiere el control fuera de un Agent de la REST API pública. No confirma la asignación en Inbox. #### WhatsApp calls - [whatsapp.call.connect](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-call-connect.md): Se produce cuando una llamada entrante proporciona una oferta SDP o una llamada iniciada por la empresa proporciona una respuesta SDP. - [whatsapp.call.terminate](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-call-terminate.md): Se produce cuando finaliza una llamada de WhatsApp. - [whatsapp.call.status.updated](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-call-status-updated.md): Se produce cuando se actualiza el estado de una llamada de WhatsApp. - [whatsapp.call.recording.updated](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-call-recording-updated.md): Se produce cuando una grabación de llamada de WhatsApp originada por API pasa a estar disponible o falla permanentemente. - [whatsapp.call.transcription.updated](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-call-transcription-updated.md): Se produce cuando una transcripción de llamada de WhatsApp iniciada por API pasa a estar disponible o falla permanentemente. #### WhatsApp groups - [whatsapp.group.lifecycle_update](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-group-lifecycle-update.md): Ocurre cuando se crea o elimina un grupo de WhatsApp, incluidos los resultados correctos y fallidos. - [whatsapp.group.participants_update](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-group-participants-update.md): Se produce cuando se actualizan los participantes de un grupo de WhatsApp o las solicitudes para unirse. - [whatsapp.group.settings_update](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-group-settings-update.md): Se produce cuando se actualiza la configuración de un grupo de WhatsApp, incluidos los resultados correctos y fallidos. - [whatsapp.group.status_update](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-group-status-update.md): Se produce cuando se actualiza el estado de suspensión de un grupo de WhatsApp. #### WhatsApp Flows and payments - [whatsapp.flow.status_change](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-flow-status-change.md): Se produce cuando se actualiza el estado de un flow de WhatsApp. - [whatsapp.payment.updated](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-payment-updated.md): Se produce cuando cambia una transacción de pago de WhatsApp. #### Contacts - [contact.attributes_changed](https://docs.ycloud.com/es/api-reference/webhook-reference/contact-attributes-changed.md): Se produce cuando cambian los atributos de un contacto. - [contact.created](https://docs.ycloud.com/es/api-reference/webhook-reference/contact-created.md): Se produce cuando se crea un contacto. - [contact.deleted](https://docs.ycloud.com/es/api-reference/webhook-reference/contact-deleted.md): Se produce cuando se elimina un contacto. - [contact.unsubscribe.created](https://docs.ycloud.com/es/api-reference/webhook-reference/contact-unsubscribe-created.md): Se produce cuando un contacto cancela su suscripción a los mensajes. - [contact.unsubscribe.deleted](https://docs.ycloud.com/es/api-reference/webhook-reference/contact-unsubscribe-deleted.md): Se produce cuando un contacto reanuda la suscripción a los mensajes. - [contact.note.created](https://docs.ycloud.com/es/api-reference/webhook-reference/contact-note-created.md): Se produce cuando se crea una nota de contacto. - [contact.note.updated](https://docs.ycloud.com/es/api-reference/webhook-reference/contact-note-updated.md): Se produce cuando se actualiza una nota de contacto. - [contact.note.deleted](https://docs.ycloud.com/es/api-reference/webhook-reference/contact-note-deleted.md): Se produce cuando se elimina una nota de contacto de forma independiente. La eliminación de un contacto no emite este evento para las notas en cascada. #### Email, SMS, and Voice - [email.delivery.updated](https://docs.ycloud.com/es/api-reference/webhook-reference/email-delivery-updated.md): Se produce cuando se actualiza el estado de entrega de un correo electrónico y el estado cambia a `delivered` o `failed`. - [sms.message.updated](https://docs.ycloud.com/es/api-reference/webhook-reference/sms-message-updated.md): Se produce cuando se actualiza el estado de un mensaje SMS y el estado cambia a `delivered` o `undelivered`. - [sms.inbound.received](https://docs.ycloud.com/es/api-reference/webhook-reference/sms-inbound-received.md): Se produce cuando se recibe un mensaje SMS entrante, lo que significa que un usuario responde a tu mensaje. - [voice.message.updated](https://docs.ycloud.com/es/api-reference/webhook-reference/voice-message-updated.md): Se produce cuando se actualiza el estado de un mensaje de voz y este cambia a `delivered` o `undelivered`. ## OpenAPI Specs - [ycloud-api-v2](/openapi/endpoints/ycloud-api-v2.yaml) - [meta-business-agent-public.openapi](/openapi/endpoints/meta-business-agent-public.openapi.json)