FlowBindPhone - Chat App Message Service - Centro de documentación de Alibaba Cloud

Descripción de la operación

Puede llamar a esta operación para vincular un número de teléfono o un ID de cuenta de comerciante a un flujo, o vincularlos manualmente en la página Flow Builder > Settings.
Antes de llamar a esta operación, asegúrese de haber creado correctamente un flujo y un canal de mensajes que corresponda al tipo de flujo.
Para el tipo de canal WhatsApp, complete el registro y vinculación de WABA y agregue un número de teléfono.
Para el tipo de canal Messenger, complete la vinculación de una cuenta de página pública.
Para el tipo de canal Instagram, complete la vinculación de una cuenta profesional.
Para el tipo de canal Viber, complete la solicitud de un ID de servicio.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

cams:FlowBindPhone

update

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
FlowCode	string	Sí	El código del flujo. Consulte el código del flujo en la página de Flow Builder.	9ccc41**************************
ChannelCode	string	Sí	El código del canal de mensajes, que corresponde al ID del canal. Consulte el ID del canal en la página de Channel Management.	cams-8c8*********
ChannelType	string	Sí	El tipo de canal de mensajes. Valores válidos: INSTAGRAM WHATSAPP MESSENGER VIBER	WHATSAPP
PhoneNumbers	array	No	La lista de números de teléfono, PageIds o AccountIds, o ServiceIds bajo la instancia del canal.
	string	No	Un único número de teléfono, PageId o AccountId, o ServiceId. Si el parámetro ChannelType está configurado como WHATSAPP, especifique el número de teléfono del comerciante bajo la instancia del canal de WhatsApp. Consulte el número de teléfono del comerciante en Channel Management > Manage > WABA Management > Number Management. Si el parámetro ChannelType está configurado como MESSENGER, especifique el PageId (ID de página pública) bajo la instancia del canal de Messenger. Consulte el ID de la página en Channel Management > Manage > Public Pages. Si el parámetro ChannelType está configurado como INSTAGRAM, especifique el AccountId (ID de cuenta profesional) bajo la instancia del canal de Instagram. Consulte el ID de la cuenta en Channel Management > Manage > Professional Accounts. Si el parámetro ChannelType está configurado como VIBER, especifique el ServiceId (ID de servicio) bajo la instancia del canal de Viber. Consulte el ID de servicio en Channel Management > Manage > Service ID Management.	86188********
WabaId	string	Sí	El ID de cuenta WABA, PageId o AccountId, o ServiceId. Si el parámetro ChannelType está configurado como WHATSAPP, especifique el ID de cuenta WABA. Consulte el ID de cuenta WABA en Channel Management > Manage > WABA Management. Si el parámetro ChannelType no está configurado como WHATSAPP, especifique el PageId para MESSENGER, el AccountId para INSTAGRAM, o el ServiceId para VIBER.	1952************
FlowVersion	string	No	La versión del flujo. Haga clic en el nombre del flujo en la página de Flow Builder para ingresar al lienzo del constructor de flujos y consultar la versión del flujo.	1
		No	La configuración de vinculación multi-WABA.

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
AccessDeniedDetail	string	Los detalles sobre la denegación de acceso.	Ninguna
Message	string	El mensaje de error.	Ninguna
RequestId	string	El ID de la solicitud.	90E63D28-E31D-1EB2-8939-A94866411B2O
Model	boolean	Indica si la operación se realizó correctamente. Valores válidos: true: La operación se realizó correctamente. false: La operación falló.	false
Code	string	El código de estado.	OK
Success	boolean	Indica si la operación se realizó correctamente. Valores válidos: true: La operación se realizó correctamente. false: La operación falló.	true

Ejemplos

Respuesta exitosa

JSON Formato

{
  "AccessDeniedDetail": "None",
  "Message": "None",
  "RequestId": "90E63D28-E31D-1EB2-8939-A94866411B2O",
  "Model": false,
  "Code": "OK",
  "Success": true
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.