Plataforma de WhatsApp Business

Administrar cuentas de WhatsApp Business

Después de insertar el flujo de registro en tu sitio web, el paso siguiente consiste en integrarlo con los extremos de API necesarios para completar el proceso.

En esta guía, se especifican las acciones que los socios de soluciones pueden tener que realizar para administrar cuentas de WhatsApp Business (WABA).

Obtener el identificador de la cuenta WABA compartida con el identificador de acceso

Cuando una empresa finaliza el flujo de registro insertado, puedes obtener el identificador de la cuenta WABA compartida mediante el valor devuelto de accessToken con el extremo del identificador de depuración. Incluye el identificador de acceso de usuario del sistema en un encabezado de la solicitud y antepón Authorization: Bearer para esta llamada a la API.

Sintaxis de la solicitud

GET https://graph.facebook.com/<API_VERSION>/debug_token
  ?input_token=<TOKEN_RETURNED_FROM_SIGNUP_FLOW>

Ejemplo de solicitud

curl \
'https://graph.facebook.com/v21.0/debug_token?input_token=EAAFl...' \
-H 'Authorization: Bearer EAAJi...'

Ejemplo de respuesta

{
  "data" : {
    "app_id" : "670843887433847",
    "application" : "JaspersMarket",
    "data_access_expires_at" : 1672092840,
    "expires_at" : 1665090000,
    "granular_scopes" : [
      {
        "scope" : "whatsapp_business_management",
        "target_ids" : [
          "102289599326934", // ID of newest WABA to grant app whatsapp_business_management
          "101569239400667"
        ]
      },
      {
        "scope" : "whatsapp_business_messaging",
        "target_ids" : [
          "102289599326934",
          "101569239400667"
        ]
      }
    ],
    "is_valid" : true,
    "scopes" : [
       "whatsapp_business_management",
       "whatsapp_business_messaging",
       "public_profile"
    ],
    "type" : "USER",
    "user_id" : "10222270944537964"
  }
}

Cada objeto de la matriz granular_scopes identifica los identificadores de todas las cuentas WABA que han concedido un permiso concreto (scope) a tu aplicación. Aparecen primero los identificadores de las cuentas WABA incorporadas más recientemente, por lo que debes capturar el primer identificador en la matriz target_ids para el ámbito whatsapp_business_management.

Obtener la lista de WABA compartidas

El extremo client_whatsapp_business_accounts recupera una lista de todas las cuentas WABA asignadas a tu cuenta de Business Manager o compartidas con esta después de completar el flujo de registro insertado.

Puedes utilizar este extremo de forma periódica para el seguimiento de las cuentas WABA que se han compartido contigo. Te permitirá ver la diferencia y buscar las que se compartieron contigo recientemente, como alternativa al enfoque del extremo del identificador de depuración que se describe en la guía de administración de cuentas de WhatsApp Business.

Se puede encontrar una lista de los campos de las cuentas WABA que se pueden solicitar desde este extremo en la referencia de cuenta de WhatsApp Business.

Sintaxis de la solicitud

GET https://graph.facebook.com/<API_VERSION>/<BUSINESS_MANAGER_ACCOUNT_ID>/client_whatsapp_business_accounts

Ejemplo de solicitud

curl \
'https://graph.facebook.com/v21.0/805021500648488/client_whatsapp_business_accounts/' \
-H 'Authorization: Bearer EAAJi...'

Ejemplo de respuesta

{
  "data": [
    {
      "id": 1906385232743451, 
      "name": "My WhatsApp Business Account", 
      "currency": "USD", 
      "timezone_id": "1", 
      "message_template_namespace": "abcdefghijk_12lmnop" 
    },
    {
      "id": 1972385232742141, 
      "name": "My Regional Account", 
      "currency": "INR", 
      "timezone_id": "5", 
      "message_template_namespace": "12abcdefghijk_34lmnop" 
    },
  ],
  "paging": {
    "cursors": {
      "before": "abcdefghij",
      "after": "klmnopqr"
    }
  }
}

Explicación de las cuentas WABA compartidas

Permisos

Un socio de soluciones tiene los siguientes permisos en una cuenta WABA compartida:

Por su parte, las empresas que se incorporen a través del registro insertado podrán ver o hacer lo siguiente:

Categoría¿Qué pueden ver las empresas?

Insights

Mensajes, costes y cambios en el estado de calidad.

Calidad

Estados y calificaciones de calidad.

Categoría¿Qué pueden hacer las empresas?

Activos

Añadir y administrar números de teléfono y plantillas.


Las empresas no pueden descargar el certificado para registrar un número de teléfono, algo que solo pueden hacer los socios de soluciones.

Administración de WABA

Dejar de compartir cuentas WABA con socios de soluciones, eliminar cuentas WABA y cambiar la configuración.

Integración con otros productos de Meta

Realizar la integración con los anuncios de clic a WhatsApp.

Los socios de soluciones no pueden inhabilitar lo que las empresas pueden ver o hacer, ni personalizar sus visualizaciones.

Las empresas pueden consultar Administrar los permisos de tu socio de soluciones de WhatsApp para obtener más información.

Notificaciones

Los socios de soluciones reciben notificaciones pertinentes mediante webhooks y Business Manager. Las notificaciones se envían cuando sucede lo siguiente:

  • Una empresa comparte una cuenta WABA.
  • Los límites de mensajes o la calificación de calidad cambian para la cuenta WABA de un cliente.
  • Cuando se aprueba una plantilla o el nombre para mostrar de un número de teléfono.

Si la empresa abandona el flujo de registro insertado antes de completarlo correctamente, es posible que haya compartido la cuenta WABA, pero el certificado no estará listo todavía para descargar. Si es el caso, ponte en contacto con la empresa para ayudarla a completar el flujo de registro integrado.

Obtener la lista de las cuentas de WhatsApp Business de propiedad

Utiliza el extremo owned_whatsapp_business_accounts para obtener una lista de las cuentas WABA propiedad de tu empresa. Para la solicitud, utiliza el identificador de acceso del usuario del sistema.

Sintaxis de la solicitud

GET https://graph.facebook.com/<API_VERSION>/<BUSINESS_MANAGER_ACCOUNT_ID>/owned_whatsapp_business_accounts

Ejemplo de solicitud

curl \
'https://graph.facebook.com/v21.0/805021500648488/owned_whatsapp_business_accounts/' \
-H 'Authorization: Bearer EAAJi...'

Ejemplo de respuesta

{
  "data": [
    {
      "id": 1906385232743451, 
      "name": "My WhatsApp Business Account", 
      "currency": "USD", 
      "timezone_id": "1", 
      "message_template_namespace": "abcdefghijk_12lmnop" 
    },
    {
      "id": 1972385232742141, 
      "name": "My Regional Account", 
      "currency": "INR", 
      "timezone_id": "5", 
      "message_template_namespace": "12abcdefghijk_34lmnop" 
    },
  ],
  "paging": {
    "cursors": {
      "before": "abcdefghij",
      "after": "klmnopqr"
    }
  }
}

Filtrar cuentas WABA por la hora de creación

Puedes filtrar las cuentas de WhatsApp Business de cliente y de propiedad por su hora de creación. Para la solicitud, puedes utilizar los parámetros que se indican a continuación.

Sintaxis de la solicitud

GET https://graph.facebook.com/<API_VERSION>/<BUSINESS_MANAGER_ACCOUNT_ID>/owned_whatsapp_business_accounts
  ?filtering=<FILTERING>

El valor de filtering puede ser una matriz que contenga un único objeto compuesto por las propiedades siguientes:

Propiedades del objeto de filtración

NombreDescripción

field

Contiene el campo que se utiliza para la filtración. Se define como creation_time.

operator

Contiene la opción que has elegido para filtrar las cuentas. Valores admitidos:


  • LESS_THAN
  • GREATER_THAN

value

Marca de tiempo UNIX que se utilizará en la filtración.

Ejemplo de objeto

[
  {
    "field" : "creation_time",
    "operator" : "GREATER_THAN",
    "value" : "1604962813"
  }
]

Ejemplo de solicitud

curl \
'https://graph.facebook.com/v21.0/805021500648488/owned_whatsapp_business_accounts' \
-H 'Authorization: Bearer EAAJi...' \
-H 'Content-Type: application/json' \
-d '[{"field":"creation_time","operator":"GREATER_THAN","value":"1604962813"}]'

Ejemplo de respuesta

{
  "data": [
    {
      "id": “12312321312”,
      "name": "test",
      "currency": "USD",
      "timezone_id": "1",
      "message_template_namespace": "46fe_814"
    }
  ],
  "paging": {
    "cursors": {
      "before": "QVFIUm9",
      "after": "QVFIUklX"
    },
    "next": "https://graph.facebook.com/v21.0/“
  }
}

Ordenar cuentas WABA por la hora de creación

Puedes ordenar las cuentas de WhatsApp Business compartidas y de propiedad por su hora de creación.

Sintaxis de la solicitud

GET https://graph.facebook.com/<API_VERSION>/<BUSINESS_MANAGER_ACCOUNT_ID>/owned_whatsapp_business_accounts
  ?sort=<SORT>

El valor de sort puede ser creation_time_ascending o creation_time_descending.

Ejemplo de solicitud

curl \
'https://graph.facebook.com/v21.0/805021500648488/owned_whatsapp_business_accounts?sort=creation_time_ascending' \
-H 'Authorization: Bearer EAAJi...'

Ejemplo de respuesta

{
  "data": [
    {
      "id": 1906385232743451,
      "name": "My WhatsApp Business Account",
      "currency": "USD",
      "timezone_id": "1",
      "message_template_namespace": "abcdefghijk_12lmnop"
    },
    {
      "id": 1972385232742141,
      "name": "My Regional Account",
      "currency": "INR",
      "timezone_id": "5",
      "message_template_namespace": "12abcdefghijk_34lmnop"
    },
  ],
  "paging": {
    "cursors": {
      "before": "abcdefghij"
      "after": "klmnopqr"
    }
  }
}

Recuperar el estado de revisión de la cuenta WABA

Para obtener el estado de revisión de una cuenta de WhatsApp Business, puedes solicitar el campo account_review_status.

Sintaxis de la solicitud

GET https://graph.facebook.com/<API_VERSION>/<WABA_ID>
  ?fields=account_review_status

Ejemplo de solicitud

curl \
'https://graph.facebook.com/v21.0/106526625562206?fields=account_review_status' \
-H 'Authorization: Bearer EAAJi...' \

Ejemplo de respuesta

{
  "account_review_status": "APPROVED",
  "id": "1111111111111"
}

La propiedad account_review_status puede tener uno de los valores siguientes: PENDING, APPROVED y REJECTED.

Más información