Límites de frecuencia

Un límite de frecuencia es el número de llamadas a la API que puede realizar una aplicación o un usuario en un periodo de tiempo determinado. Si dicho límite se excede o si se superan los límites de tiempo total o de CPU, es posible que la aplicación o el usuario se vean limitados. Las solicitudes a la API que realice una aplicación o usuario limitados devolverán un error.

Todas las solicitudes a la API están sujetas a límites de frecuencia. Las solicitudes a la API Graph y la API de visualización básica de Instagram están sujetas a los límites de frecuencia de la plataforma, mientras que las solicitudes a la API de marketing y la API de la plataforma de Instagram están sujetas a los límites de frecuencia de casos de uso comercial (BUC).

Las solicitudes a la API de páginas están sujetas a los límites de frecuencia de la plataforma o BUC, en función del identificador usado en la solicitud; las solicitudes realizadas con los identificadores de acceso a la aplicación o de usuario están sujetas a los límites de frecuencia de la plataforma, mientras que las solicitudes realizadas con identificadores de acceso de usuario del sistema o a la página están sujetas a los límites de frecuencia de casos de uso comercial.

Las estadísticas de uso del límite de frecuencia en tiempo real se describen en los encabezados que se incluyen con la mayoría de respuestas de la API una vez que se han realizado suficientes llamadas a un extremo. También se muestran las estadísticas de uso del límite de frecuencia de la plataforma en el panel de aplicaciones. Cuando se alcance un límite de frecuencia, se producirá un error en cualquier solicitud posterior que realice la aplicación, y la API devolverá un código de error hasta que transcurra suficiente tiempo para que el recuento de llamadas esté por debajo del límite.

Si se pueden aplicar límites de frecuencia tanto de la plataforma como de casos de uso comercial a una solicitud, se aplicarán los límites de frecuencia de BUC.

Límites de frecuencia de la plataforma

El seguimiento de los límites de frecuencia de la plataforma se realiza en el nivel de aplicación o usuario de forma individual, en función del tipo de identificador usado en la solicitud.

Aplicaciones

Las solicitudes a la API Graph realizadas con un identificador de acceso a la aplicación se incluyen en el recuento del límite de frecuencia de la aplicación. El recuento de llamadas de una aplicación es el número de llamadas que esta puede realizar durante un periodo continuo de una hora y se calcula de la siguiente forma:

Calls within one hour = 200 * Number of Users

El número de usuarios se basa en la cantidad de usuarios activos por día únicos que tiene una aplicación. En aquellos casos en que existan periodos atrasados de uso diario (por ejemplo, si la actividad de la aplicación es alta durante los fines de semana pero baja en los días laborables), se usarán los usuarios activos por semana y mes para calcular el número de usuarios de la aplicación. Las aplicaciones con una alta interacción diaria tendrán límites de frecuencia más altos que las aplicaciones con una interacción diaria baja, independientemente del número real de descargas de la aplicación.

Ten en cuenta que no se trata de un límite por usuario, sino de un límite en las llamadas que realiza la aplicación. Cualquier usuario individual puede realizar más de 200 llamadas por hora mediante la aplicación, siempre que el total de las que se realicen desde la aplicación no supere el máximo de dicha aplicación. Por ejemplo, si la aplicación tiene 100 usuarios, puede realizar 20 000 llamadas por hora. No obstante, los diez usuarios que más interactúan pueden realizar 19 000 de estas llamadas.

Usuarios

Las solicitudes a la API Graph realizadas con un identificador de acceso de usuario se incluyen en el recuento de llamadas del usuario. El recuento de llamadas de un usuario es la cantidad de llamadas que este puede realizar durante un periodo continuo de una hora. Por motivos de privacidad, no revelamos los valores de recuento de llamadas reales de los usuarios.

Ten en cuenta que el recuento de llamadas de un usuario puede distribuirse entre varias aplicaciones. Por ejemplo, un usuario puede realizar X llamadas mediante la aplicación 1 e Y llamadas mediante la aplicación 2. Si la suma de X e Y supera el recuento de llamadas del usuario, se le aplicará un límite de frecuencia. Esto no significa necesariamente que el comportamiento de la aplicación sea incorrecto, sino que puede ser que el usuario utilice varias aplicaciones o use la API de forma indebida.

Encabezados

Los extremos que reciben suficientes solicitudes de la aplicación incluirán un encabezado HTTP X-App-Usage o X-Ad-Account-Usage (para las llamadas a la versión 3.3 y anteriores de la API de anuncios) en las respuestas. El encabezado contendrá una cadena con formato JSON que describe el uso actual del límite de frecuencia de la aplicación.

Contenido del encabezado

Clave	Descripción del valor
`call_count`	Número entero que expresa el porcentaje de llamadas que realiza la aplicación durante un periodo continuo de una hora.
`total_cputime`	Número entero que expresa el porcentaje de tiempo de la CPU asignado para el procesamiento de consultas.
`total_time`	Número entero que expresa el porcentaje de tiempo total asignado para el procesamiento de consultas.

Contenido del encabezado X-Ad-Account-Usage

Clave	Descripción del valor
`acc_id_util_pct`	Porcentaje de llamadas realizadas para esta cuenta publicitaria antes de alcanzar el límite de frecuencia.
`reset_time_duration`	Duración (en segundos) del tiempo que se tarda en restablecer el límite de frecuencia actual a 0.
`ads_api_access_tier`	Los niveles permiten que tu aplicación acceda a la API de marketing. De forma predeterminada, las aplicaciones están en el nivel `development_access`. `Standard_access` permite una limitación de frecuencia menor. Para obtener un límite de frecuencia mayor y llegar al nivel estándar, puedes solicitar “acceso avanzado” a la función Acceso estándar a la administración de anuncios.

Tiempo total de la CPU

Cantidad de tiempo de la CPU que tarda en procesarse la solicitud. Cuando el valor de total_cputime llegue a 100, es posible que se limiten las llamadas.

Tiempo total

Cantidad de tiempo que tarda en procesarse la solicitud. Cuando el valor de total_time llegue a 100, es posible que se limiten las llamadas.

Valor de ejemplo del encabezado X-App-Usage

x-app-usage: {
    "call_count": 28,         //Percentage of calls made 
    "total_time": 25,         //Percentage of total time
    "total_cputime": 25       //Percentage of total CPU time
}

Valor de ejemplo del encabezado X-Ad-Account-Usage

x-ad-account-usage: {
    "acc_id_util_pct": 9.67,   //Percentage of calls made for this ad account.
    "reset_time_duration": 100,   //Time duration (in seconds) it takes to reset the current rate limit score.
    "ads_api_access_tier": 'standard_access'   //Tiers allows your app to access the Marketing API. standard_access enables lower rate limiting.
}

Panel

En el panel de aplicaciones se muestra el número de usuarios de la aplicación con límite de frecuencia, el porcentaje de uso actual de los límites de frecuencia de la aplicación y la actividad media de los últimos siete días. En la tarjeta Límite de frecuencia de la aplicación, haz clic en Ver detalles y pasa el cursor sobre cualquier punto del gráfico para ver más detalles sobre el uso en ese momento concreto. Dado que el uso depende del volumen de llamadas, es posible que en este gráfico no se muestren los siete días completos. Las aplicaciones con un volumen de llamadas más alto mostrarán más días.

Códigos de error

Cuando una aplicación o un usuario haya alcanzado su límite de frecuencia, se producirá un error en las solicitudes de la aplicación o el usuario y la API responderá con un código de error.

Códigos de error de restricción

Código de error	Descripción
`4`	Indica que la aplicación cuyo identificador se usa en la solicitud ha alcanzado su límite de frecuencia.
`17`	Indica que el usuario cuyo identificador se usa en la solicitud ha alcanzado su límite de frecuencia.
`17 with subcode 2446079`	Indica que el identificador que se usa en la solicitud a la versión 3.3 o anterior de la API de anuncios ha alcanzado su límite de frecuencia.
`32`	Indica que el usuario o la aplicación cuyo identificador se usa en la solicitud a la API de páginas ha alcanzado su límite de frecuencia.
`613`	Indica que se ha alcanzado un límite de frecuencia personalizado. Para ayudar a resolver este problema, consulta los documentos complementarios de la API específica a la que llamas para ver los límites de frecuencia personalizados que pueden aplicarse.
`613 with subcode 1996`	Indica que se ha observado un comportamiento incoherente en el volumen de solicitudes a la API de la aplicación. Si has realizado algún cambio recientemente que afecte al número de solicitudes a la API, es posible que se muestre este error.

Ejemplo de respuesta

{
  "error": {
    "message": "(#32) Page request limit reached",
    "type": "OAuthException",
    "code": 32,
    "fbtrace_id": "Fz54k3GZrio"
  }
}

Códigos de restricción de estabilidad de Facebook

Código de error Descripción

Código de error	Descripción
`throttled`	Indica si la consulta está limitada o no. Valores: `True` o `False`.
`backend_qps`	Primer factor de restricción `backend_qps`. Valores admitidos: `actual_score`: valor real de `backend_qps` de esta aplicación. Valor: `8`. `limit`: límite del valor de `backend_qps` de esta aplicación. Valor: `5`. `more_info`: las consultas necesitan gestionar un gran número de solicitudes de back-end. Te sugerimos que envíes menos consultas o que las simplifiques con intervalos de tiempo más reducidos, menos identificadores de objeto, etc.
`complexity_score`	Segundo factor de restricción `complexity_score`. Valores admitidos: `actual_score`: valor real de `complexity_score` de esta aplicación. Valor: `0.1`. `limit`: límite del valor de `complexity_score` de esta aplicación. Valor: `0.01`. `more_info`: un valor alto de `complexity_score` significa que las consultas son muy complejas y solicitan grandes cantidades de datos. Te sugerimos que simplifiques las consultas con intervalos de tiempo más reducidos, menos identificadores de objeto, métricas o desgloses, etc. Divide las consultas grandes y complejas en otras más pequeñas y espácialas.

throttled

Indica si la consulta está limitada o no. Valores: True o False.

backend_qps

Primer factor de restricción backend_qps. Valores admitidos:

actual_score: valor real de backend_qps de esta aplicación. Valor: 8.
limit: límite del valor de backend_qps de esta aplicación. Valor: 5.
more_info: las consultas necesitan gestionar un gran número de solicitudes de back-end. Te sugerimos que envíes menos consultas o que las simplifiques con intervalos de tiempo más reducidos, menos identificadores de objeto, etc.

complexity_score

Segundo factor de restricción complexity_score. Valores admitidos:

actual_score: valor real de complexity_score de esta aplicación. Valor: 0.1.
limit: límite del valor de complexity_score de esta aplicación. Valor: 0.01.
more_info: un valor alto de complexity_score significa que las consultas son muy complejas y solicitan grandes cantidades de datos. Te sugerimos que simplifiques las consultas con intervalos de tiempo más reducidos, menos identificadores de objeto, métricas o desgloses, etc. Divide las consultas grandes y complejas en otras más pequeñas y espácialas.

Prácticas recomendadas

Cuando se alcance el límite, deja de realizar llamadas a la API. Si sigues realizándolas, el recuento de llamadas continuará creciendo, de forma que aumentará el tiempo que deberá transcurrir para que las llamadas se vuelvan a realizar correctamente.
Distribuye las consultas de forma uniforme para evitar picos de tráfico.
Utiliza filtros para limitar el tamaño de la respuesta de datos y evitar llamadas que soliciten datos superpuestos.
Consulta el encabezado HTTP X-App-Usage para ver cuánto falta para que la aplicación alcance el límite y cuándo podrás volver a realizar llamadas después de que se alcance el límite.
Si se limitan los usuarios, asegúrate de que la causa no sea la aplicación. Reduce las llamadas del usuario o distribúyelas de forma más uniforme en el tiempo.

Límites de frecuencia de casos de uso comercial

Todas las solicitudes a la API de marketing y las solicitudes a la API de páginas realizadas con un identificador de acceso al sistema o la página están sujetas a los límites de frecuencia de casos de uso comercial (BUC) y dependen de los extremos que consultes.

En el caso de la API de marketing, el límite de frecuencia se aplica a la cuenta publicitaria en el mismo caso de uso comercial. Por ejemplo, todos los extremos con el caso de uso comercial Administración de anuncios compartirán la cuota total dentro de la misma cuenta publicitaria. Si un determinado extremo hace muchas solicitudes a la API y provoca restricciones, otros extremos configurados con el mismo caso de uso comercial también recibirán errores de limitación de frecuencia. La cuota depende del nivel de acceso a la API de marketing de la aplicación. El nivel de la API de marketing de acceso estándar tendrá más cuotas que el nivel de la API de marketing de acceso de desarrollo. De forma predeterminada, una aplicación nueva debe estar en el nivel de desarrollo. Si necesitas actualizar para obtener más cuota de limitación de frecuencia, actualiza al acceso avanzado de Acceso estándar a la administración de anuncios en la revisión de la aplicación.

Insights de anuncios
Administración de anuncios
Catálogo
Audiencia personalizada
Plataforma de Instagram
Generación de clientes potenciales

Messenger
Páginas
Administración de efectos comerciales de Spark AR
API de administración de WhatsApp Business

Insights de anuncios

Las solicitudes que realiza una aplicación a la API de insights de anuncios se contabilizan con respecto a las métricas de límite de frecuencia de la aplicación, como el recuento de llamadas, el tiempo total de la CPU y el tiempo total. El recuento de llamadas de una aplicación es el número de llamadas que esta puede realizar durante un periodo continuo de una hora y se calcula de la siguiente forma:

En el caso de las aplicaciones con acceso estándar a la función Acceso estándar a la administración de anuncios:

Calls within one hour = 600 + 400 * Number of Active ads - 0.001 * User Errors

En el caso de las aplicaciones con acceso avanzado a la función Acceso estándar a la administración de anuncios:

Calls within one hour = 190000 + 400 * Number of Active ads - 0.001 * User Errors

El número de anuncios activos es la cantidad de anuncios que se encuentran actualmente en circulación en cada cuenta publicitaria. Los errores del usuario son el número de errores recibidos al llamar a la API. Para obtener un límite de frecuencia mayor, puedes solicitar la función Acceso estándar a la administración de anuncios.

La limitación de frecuencia también puede estar sujeta al tiempo total de la CPU y al tiempo real total durante un periodo continuo de una hora. Para obtener más información, comprueba el encabezado HTTP X-Business-Use-Casetotal_cputime y total_time.

Si recibes errores de limitación de frecuencia, también puede consultar estimated_time_to_regain_access en el encabezado X-Business-Use-Case para saber el tiempo estimado del bloqueo.

Administración de anuncios

Las solicitudes que realiza una aplicación a la API de administración de anuncios se contabilizan con respecto a las métricas de límite de frecuencia de la aplicación, como el recuento de llamadas, el tiempo total de la CPU y el tiempo total. El recuento de llamadas de una aplicación es el número de llamadas que esta puede realizar durante un periodo continuo de una hora y se calcula de la siguiente forma:

En el caso de las aplicaciones con acceso estándar a la función Acceso estándar a la administración de anuncios:

Calls within one hour = 300 + 40 * Number of Active ads

En el caso de las aplicaciones con acceso avanzado a la función Acceso estándar a la administración de anuncios:

Calls within one hour = 100000 + 40 * Number of Active ads

El número de anuncios activos es la cantidad de anuncios de cada cuenta publicitaria.

Si recibes errores de limitación de frecuencia, también puede consultar estimated_time_to_regain_access en el encabezado X-Business-Use-Case para saber el tiempo estimado del bloqueo.

Catálogo

Lote del catálogo

Las solicitudes que realiza una aplicación se contabilizan con respecto a las métricas de límite de frecuencia, como el recuento de llamadas, el tiempo total de la CPU y el tiempo total que puede realizar la aplicación en un periodo continuo de una hora por identificador de catálogo, y se calcula como se indica a continuación:

Calls within one hour = 200 + 200 * log2(unique users)

El número de usuarios únicos es la cantidad de usuarios únicos de la empresa (en todos los catálogos) con algún tipo de intención en los últimos 28 días. Cuantos más usuarios vean los productos de tus catálogos, más cuota de llamadas se asigna.

Tipo de llamada	Extremo
POST	/{catalog_id}/items_batch
POST	/{catalog_id}/localized_items_batch
POST	/{catalog_id}/batch

Administración de catálogos

Las solicitudes que realiza una aplicación se contabilizan con respecto a la cantidad de llamadas que puede realizar en un periodo continuo de una hora por identificador de catálogo, y se calcula como se indica a continuación:

Calls within one hour = 20,000 + 20,000 * log2(unique users)

Esta fórmula se aplica en varios extremos de catálogo.

Si necesitas más información sobre cómo obtener el uso de la frecuencia actual, consulta Encabezados.

Si recibes errores de limitación de frecuencia, también puede consultar estimated_time_to_regain_access en el encabezado X-Business-Use-Case para saber el tiempo estimado del bloqueo.

Audiencia personalizada

Las solicitudes que realiza una aplicación a la API de audiencias personalizadas se contabilizan con respecto a las métricas de límite de frecuencia de la aplicación, como el recuento de llamadas, el tiempo total de la CPU y el tiempo total. El recuento de llamadas de una aplicación es la cantidad de llamadas que puede realizar durante un periodo continuo de una hora. No puede superar las 700 000 llamadas y se calcula como se indica a continuación:

En el caso de las aplicaciones con acceso estándar a la función Acceso estándar a la administración de anuncios:

Calls within one hour = 5000 + 40 * Number of Active Custom Audiences

En el caso de las aplicaciones con acceso avanzado a la función Acceso estándar a la administración de anuncios:

Calls within one hour = 190000 + 40 * Number of Active Custom Audiences

El número de audiencias personalizadas activas es la cantidad de audiencias personalizadas activas que hay en cada cuenta publicitaria.

Si recibes errores de limitación de frecuencia, también puede consultar estimated_time_to_regain_access en el encabezado X-Business-Use-Case para saber el tiempo estimado del bloqueo.

Plataforma de Instagram

Calls to the Instagram Platform endpoints, excluding messaging, are counted against the calling app's call count. An app's call count is unique for each app and app user pair, and is the number of calls the app has made in a rolling 24 hour window. It is calculated as follows:

Calls within 24 hours = 4800 * Number of Impressions

The Number of Impressions is the number of times any content from the app user's Instagram professional account has entered a person's screen within the last 24 hours.

Notes

The Instagram Basic Display API uses Platform Rate Limits.

Business Discovery and Hashtag Search API are subject to Platform Rate Limits.

Messaging Rate Limits

Calls to the Instagram messaging endpoints are counted against the number of calls your app can make per Instagram professional account and the API used.

Conversations API

Your app can make 2 calls per second per Instagram professional account.

Private Replies API

Your app can make 100 calls per second per Instagram professional account for private replies to Instagram Live comments
Your app can make 750 calls per hour per Instagram professional account for private replies to comments on Instagram posts and reels

Send API

Your app can make 100 calls per second per Instagram professional account for messages that contain text, links, reactions, and stickers
Your app can make 10 calls per second per Instagram professional account for messages that contain audio or video content

Generación de clientes potenciales

Las solicitudes que realiza la aplicación a la API de generación de clientes potenciales se incluyen en el recuento de llamadas de la aplicación. El recuento de llamadas de una aplicación es la cantidad de llamadas que puede realizar durante un intervalo periódico de 24 horas, y se calcula como se indica a continuación:

Calls within 24 hours = 4800 * Leads Generated

El número de clientes potenciales generados es la cantidad de clientes potenciales generados por página para esta cuenta publicitaria en los últimos 90 días.

Plataforma de Messenger

Los límites de frecuencia de la plataforma de Messenger dependen de la API que se utilice y, en algunos casos, del contenido de los mensajes.

API de Messenger

Las solicitudes que realiza una aplicación se contabilizan con respecto a la cantidad de llamadas que puede realizar en un periodo renovable de 24 horas, y se calcula como se indica a continuación:



Calls within 24 hours = 200 * Number of Engaged Users

El número de usuarios que interactúan es la cantidad de usuarios a los que la empresa puede enviar mensajes mediante Messenger.

API de Messenger para Instagram

Las solicitudes que realiza una aplicación se contabilizan con respecto a la cantidad de llamadas que puede realizar por cuenta profesional de Instagram y la API utilizada.

API de conversaciones

Una aplicación puede realizar dos llamadas por segundo por cuenta profesional de Instagram.

API de envío

Una aplicación puede realizar 100 llamadas por segundo por cuenta profesional de Instagram para mensajes que incluyan texto, enlaces, reacciones y stickers.
Una aplicación puede realizar diez llamadas por segundo por cuenta profesional de Instagram para mensajes que incluyan contenido de vídeo o audio.

API de respuestas privadas

Una aplicación puede realizar 100 llamadas por segundo por cuenta profesional de Instagram para respuestas privadas a comentarios de Instagram Live.
Una aplicación puede realizar 750 llamadas por hora por cuenta profesional de Instagram para respuestas privadas a comentarios en reels y publicaciones de Instagram.

Páginas

Los límites de frecuencia de las páginas pueden usar la lógica de límite de frecuencia de la plataforma o BUC, en función del tipo de identificador que se use. Cualquier llamada a la API de páginas que se lleve a cabo mediante un identificador de acceso a la página o de usuario del sistema usa el cálculo del límite de frecuencia siguiente. Cualquier llamada que se lleve a cabo mediante identificadores de acceso a la aplicación o de usuario está sujeta a los límites de frecuencia de la aplicación o el usuario.

Las solicitudes que realiza la aplicación a la API de páginas mediante un identificador de acceso a la página o de usuario del sistema se incluyen en el recuento de llamadas de la aplicación. El recuento de llamadas de una aplicación es la cantidad de llamadas que puede realizar durante un intervalo periódico de 24 horas, y se calcula como se indica a continuación:

Calls within 24 hours = 4800 * Number of Engaged Users

El número de usuarios que interactúan es la cantidad de usuarios que han interactuado con la página en 24 horas.

Las solicitudes que realiza la aplicación a la API de páginas mediante un identificador de acceso de usuario o a la aplicación siguen la lógica de límite de frecuencia de la plataforma.

Para evitar problemas con la limitación de frecuencia al usar la función de acceso al contenido público de la página, se recomienda utilizar un identificador de acceso de usuario del sistema.

Administración de efectos comerciales de Spark AR

Las solicitudes que realiza la aplicación a los extremos de comercio se incluyen en el recuento de llamadas de la aplicación. El recuento de llamadas de una aplicación es el número de llamadas que esta puede realizar durante un periodo continuo de una hora y se calcula de la siguiente forma:

Calls within one hour = 200 + 40 * Number of Catalogs

El número de catálogos es el número total de catálogos en todas las cuentas comerciales que administra tu aplicación.

Threads

Calls to the Threads API are counted against the calling app's call count. An app's call count is unique for each app and app user pair and is the number of calls the app has made in a rolling 24-hour window. It is calculated as follows:

Calls within 24 hours = 4800 * Number of Impressions

The Number of Impressions is the number of times any content from the app user's Threads account has entered a person's screen within the last 24 hours. Rate limiting may also be subject to total CPU time per day:

720000 * number_of_impressions for total_cputime 

      2880000 * Number of Impressions for total_time

Note: The minimum value for impressions is 10 (so if the impressions is less than 10 we default to 10).

API de administración de WhatsApp Business

Las solicitudes que realiza la aplicación a la API de administración de WhatsApp Business se incluyen en el recuento de la aplicación. El recuento de llamadas de una aplicación es el número de llamadas que esta puede realizar durante un periodo renovable de una hora. En el caso de la siguiente API de administración de WhatsApp Business, la aplicación puede realizar de forma predeterminada 200 llamadas por hora, por aplicación, por cuenta de WhatsApp Business (WABA). En el caso de las cuentas WABA activas con al menos un número de teléfono registrado, la aplicación puede realizar 5000 llamadas por hora, por aplicación, por cuenta WABA activa.

Tipo de llamada	Extremo
`GET`	`/{whatsapp-business-account-id}`
`GET`, `POST` y `DELETE`	`/{whatsapp-business-account-id}/assigned_users`
`GET`	`/{whatsapp-business-account-id}/phone_numbers`
`GET`, `POST` y `DELETE`	`/{whatsapp-business-account-id}/message_templates`
`GET`, `POST` y `DELETE`	`/{whatsapp-business-account-id}/subscribed_apps`
`GET`	`/{whatsapp-business-account-to-number-current-status-id}`

En el caso de las siguientes API de línea de crédito, la aplicación puede hacer 5000 llamadas por hora, por aplicación.

Tipo de llamada	Extremo
`GET`	`/{business-id}/extendedcredits`
`POST`	`/{extended-credit-id}/whatsapp_credit_sharing_and_attach`
`GET` y `DELETE`	`/{allocation-config-id}`
`GET`	`/{extended-credit-id}/owning_credit_allocation_configs`

A fin de evitar alcanzar los límites de frecuencia, recomendamos usar webhooks para hacer un seguimiento de las actualizaciones de estado de las plantillas de mensajes, los números de teléfono y las cuentas WABA.

Si necesitas más detalles sobre cómo obtener información del uso de la frecuencia actual, consulta Encabezados.

Encabezados

Las respuestas de la API que realiza la aplicación con una limitación de frecuencia que usa la lógica de BUC incluyen un encabezado HTTP X-Business-Use-Case-Usage (en el caso de las llamadas a la versión 3.3 y anteriores de la API de anuncios) con una cadena con formato JSON que describe el uso actual del límite de frecuencia de la aplicación. Este encabezado puede devolver hasta 32 objetos en una llamada.

Contenido del encabezado X-Business-Use-Case-Usage

Código de error	Descripción del valor
`business-id`	Identificador de la empresa asociada al identificador que realiza las llamadas a la API.
`call_count`	Número entero que expresa el porcentaje de llamadas permitidas que realiza la aplicación durante un periodo continuo de una hora.
`estimated_time_to_regain_access`	Tiempo, en minutos, que debe transcurrir hasta que las llamadas dejen de limitarse.
`total_cputime`	Número entero que expresa el porcentaje de tiempo de la CPU asignado para el procesamiento de consultas.
`total_time`	Número entero que expresa el porcentaje de tiempo total asignado para el procesamiento de consultas.
`type`	Tipo de límite de frecuencia aplicado. El valor puede ser uno de los siguientes: `ads_insights`, `ads_management`, `custom_audience`, `instagram`, `leadgen`, `messenger` o `pages`.
`ads_api_access_tier`	Solo para los tipos `ads_insights` y `ads_management`. Los niveles permiten que tu aplicación acceda a la API de marketing. De forma predeterminada, las aplicaciones están en el nivel `development_access`. `Standard_access` permite una limitación de frecuencia menor. Para obtener un límite de frecuencia mayor y llegar al nivel estándar, puedes solicitar “acceso avanzado” a la función Acceso estándar a la administración de anuncios.

Tiempo total de la CPU

Cantidad de tiempo de la CPU que tarda en procesarse la solicitud. Cuando el valor de total_cputime llegue a 100, es posible que se limiten las llamadas.

Tiempo total

Cantidad de tiempo que tarda en procesarse la solicitud. Cuando el valor de total_time llegue a 100, es posible que se limiten las llamadas.

Nivel de acceso a la API de anuncios

Solo para los tipos ads_insights y ads_management. Los niveles permiten que tu aplicación acceda a la API de marketing. De forma predeterminada, las aplicaciones están en el nivel development_access. Standard_access permite una limitación de frecuencia menor. Para obtener un límite de frecuencia mayor y llegar al nivel estándar, puedes solicitar “acceso avanzado” a la función Acceso estándar a la administración de anuncios.

Valor de ejemplo del encabezado X-Business-Use-Case-Usage

x-business-use-case-usage: {
    "{business-object-id}": [
        {
            "type": "{rate-limit-type}",           //Type of BUC rate limit logic being applied.
            "call_count": 100,                     //Percentage of calls made. 
            "total_cputime": 25,                   //Percentage of the total CPU time that has been used.
            "total_time": 25,                      //Percentage of the total time that has been used.   
            "estimated_time_to_regain_access": 19,  //Time in minutes to regain access.
            "ads_api_access_tier": "standard_access"  //Tiers allows your app to access the Marketing API. standard_access enables lower rate limiting.
        }
    ],      
    "66782684": [
        {
            "type": "ads_management",
            "call_count": 95,
            "total_cputime": 20,
            "total_time": 20,
            "estimated_time_to_regain_access": 0,
            "ads_api_access_tier": "development_access" 
        }
    ],
    "10153848260347724": [
        {
            "type": "ads_insights",
            "call_count": 97,
            "total_cputime": 23,
            "total_time": 23,
            "estimated_time_to_regain_access": 0,
            "ads_api_access_tier": "development_access"
        }
    ],
    "10153848260347724": [
        {
            "type": "pages",
            "call_count": 97,
            "total_cputime": 23,
            "total_time": 23,
            "estimated_time_to_regain_access": 0
        }
    ],
...
}

Códigos de error

Cuando la aplicación alcanza el límite de frecuencia de casos de uso comercial, cualquier solicitud posterior que realice la aplicación producirá un error y la API devolverá un código de error.

Código de error	Tipo de límite de frecuencia de BUC
`error code 80000, error subcode 2446079`	Insights de anuncios
`error code 80004, error subcode 2446079`	Administración de anuncios
`error code 80003, error subcode 2446079`	Audiencia personalizada
`error code 80002`	Instagram
`error code 80005`	Generación de clientes potenciales
`error code 80006`	Messenger
`error code 32`	Llamadas a la página realizadas con un identificador de acceso de usuario
`error code 80001`	Llamadas a la página realizadas con un identificador de acceso a la página o de usuario del sistema
`error code 17, error subcode 2446079`	Versión 3.3 y anteriores de la API de anuncios (excepto la de insights de anuncios)
`error code 80008`	API de administración de WhatsApp Business
`error code 80014`	Lote del catálogo
`error code 80009`	Administración de catálogos

Ejemplo de un mensaje de código de error

{   
"error": {      
    "message": "(#80001) There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.",      
    "type": "OAuthException",      
    "code": 80001,      
    "fbtrace_id": "AmFGcW_3hwDB7qFbl_QdebZ"   
    }
}

Prácticas recomendadas

Cuando se alcance el límite, deja de realizar llamadas a la API. Si sigues realizándolas, el recuento de llamadas continuará creciendo, de forma que aumentará el tiempo que deberá transcurrir para que las llamadas se vuelvan a realizar correctamente.
Consulta el encabezado HTTP X-Business-Use-Case-Usage para ver cuánto falta para que la cuenta publicitaria alcance el límite y cuándo puedes volver a realizar llamadas.
Verifica el código de error y el extremo de la API para confirmar el tipo de restricción.
Cambia a otras cuentas publicitarias y regresa a esta después.
Es mejor crear un nuevo anuncio que modificar los existentes.
Reparte las consultas de manera uniforme entre dos intervalos de tiempo para evitar el envío de tráfico en picos.
Utiliza filtros para limitar el tamaño de la respuesta de datos y evitar llamadas que soliciten datos superpuestos.

Preguntas frecuentes

¿Qué consideramos que es una llamada a la API?

Todas las llamadas se incluyen en el recuento de los límites de frecuencia, no solo las solicitudes individuales a la API. Por ejemplo, puedes realizar una sola solicitud a la API y especificar varios identificadores, pero cada uno contará como una llamada.

En la tabla siguiente se ilustra este concepto.

Solicitudes de ejemplo Número de llamadas a la API

Solicitudes de ejemplo	Número de llamadas a la API
`GET https://graph.facebook.com/photos?ids=4` `GET https://graph.facebook.com/photos?ids=5` `GET https://graph.facebook.com/photos?ids=6`	3
`GET https://graph.facebook.com/photos?ids=4,5,6`	3

GET https://graph.facebook.com/photos?ids=4

GET https://graph.facebook.com/photos?ids=5

GET https://graph.facebook.com/photos?ids=6

GET https://graph.facebook.com/photos?ids=4,5,6

Cuando sea posible, te recomendamos que especifiques varios identificadores en una solicitud a la API, ya que, de este modo, mejorará el rendimiento de las respuestas de la API.

Voy a crear una herramienta de extracción, ¿hay algo más de lo que deba preocuparme?

Si vas a crear un servicio de extracción de datos, consulta nuestras condiciones de extracción.