Todos os produtos
Search
Central de documentação

Chat App Message Service:ChatappSyncPhoneNumber

Última atualização: Jul 07, 2026

Sincroniza informações de números de telefone.

Descrição da operação

O limite de QPS específico para a China desta API é de 10 chamadas por segundo. Se esse limite for excedido, as chamadas da API serão limitadas, o que pode afetar seus negócios. Chame esta operação com uma frequência razoável.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cams:ChatappSyncPhoneNumber

list

*Todos os recursos.

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

CustSpaceId

string

Sim

O SpaceId do subcliente ISV.

293483938849493****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros de resposta.

AccessDeniedDetail

string

Os detalhes sobre a negação de acesso.

无

PhoneNumbers

array<object>

A lista de números de telefone.

array<object>

O objeto.

VerifiedName

string

O nome verificado do número de telefone.

Alibaba

Status

string

O status do número de telefone.

Valores válidos:

  • MIGRATED :

    MIGRATED.

  • FLAGGED :

    FLAGGED.

  • DISCONNECTED :

    DISCONNECTED.

  • UNVERIFIED :

    UNVERIFIED.

  • BANNED :

    BANNED.

  • RATE_LIMITED :

    RATE_LIMITED.

  • PENDING :

    PENDING.

  • CONNECTED :

    CONNECTED.

  • UNKNOWN :

    UNKNOWN.

  • DELETED :

    DELETED.

  • RESTRICTED :

    RESTRICTED.

PENDING

UpQueue

string

O MSMQ upstream.

alicom-0939****-queue

NameStatus

string

O status de revisão do nome.

Approval

MessagingLimitTier

string

O nível de limite de mensagens do número de telefone.

Valores válidos:

  • TIER_100K :

    100000

  • TIER_UNLIMITED :

    unlimited.

  • TIER_250 :

    250

  • TIER_1K :

    1000

  • TIER_50 :

    50

  • TIER_10K :

    10000

TIER_10K

StatusCallbackUrl

string

A URL de callback para relatórios de status.

https://www.alibaba.com/status

QualityRating

string

A classificação de qualidade do número de telefone.

Valores válidos:

  • RED :

    RED.

  • YELLOW :

    YELLOW.

  • GREEN :

    GREEN.

GREEN

CodeVerificationStatus

string

O status de verificação. Valores válidos:

  • REVOKED: A solicitação de verificação foi revogada.

  • MORE_INFORMATION_REQUESTED: Mais informações são necessárias.

  • VERIFIED: A verificação foi aprovada.

  • REJECTED: A verificação foi rejeitada.

Valores válidos:

  • REVOKED :

    A solicitação de verificação foi revogada.

  • MORE_INFORMATION_REQUESTED :

    Mais informações são necessárias.

  • VERIFIED :

    A verificação foi aprovada.

  • REJECTED :

    A verificação foi rejeitada.

VERIFIED

NewNameStatus

string

O status de revisão do novo nome.

Approval

CallingConfigure

object

Calling

object

Status

string

ENABLED

CallHours

object

Status

string

ENABLED

HolidaySchedule

array<object>

object

EndTime

string

2359

StartTime

string

0000

Date

string

2026-01-01

TimezoneId

string

Asia/Shanghai

WeeklyOperatingHours

array<object>

object

OpenTime

string

0000

DayOfWeek

string

MONDAY

CloseTime

string

2359

CallbackPermissionStatus

string

示例值示例值示例值

CallIconVisibility

string

DEFAULT

MaxTalkTime

integer

100

CallingCallbackUrl

string

http://aliyun.com

PhoneNumber

string

O número de telefone.

861380000****

StatusQueue

string

A fila de relatórios de status.

alicom-0939****-queue

IsOfficial

string

Indica se o número de telefone possui certificação OBA.

N

UpCallbackUrl

string

A URL de callback para mensagens upstream.

https://www.alibaba.com/inbound

Message

string

A mensagem de erro.

无

RequestId

string

O ID da solicitação.

90E63D28-E31D-1EB2-8939-A94866411B2O

Code

string

O código de resposta.

  • Um valor OK indica que a solicitação foi bem-sucedida.

  • Para outros códigos de erro, consulte Códigos de erro.

OK

Success

boolean

Indica se a chamada foi bem-sucedida. Valores válidos:

  • true: A chamada foi bem-sucedida.

  • false: A chamada falhou.

true

Exemplos

Resposta de sucesso

JSON formato

{
  "AccessDeniedDetail": "无",
  "PhoneNumbers": [
    {
      "VerifiedName": "Alibaba",
      "Status": "PENDING",
      "UpQueue": "alicom-0939****-queue",
      "NameStatus": "Approval",
      "MessagingLimitTier": "TIER_10K",
      "StatusCallbackUrl": "https://www.alibaba.com/status",
      "QualityRating": "GREEN",
      "CodeVerificationStatus": "VERIFIED",
      "NewNameStatus": "Approval",
      "CallingConfigure": {
        "Calling": {
          "Status": "ENABLED",
          "CallHours": {
            "Status": "ENABLED",
            "HolidaySchedule": [
              {
                "EndTime": "2359",
                "StartTime": "0000",
                "Date": "2026-01-01"
              }
            ],
            "TimezoneId": "Asia/Shanghai",
            "WeeklyOperatingHours": [
              {
                "OpenTime": "0000",
                "DayOfWeek": "MONDAY",
                "CloseTime": "2359"
              }
            ]
          },
          "CallbackPermissionStatus": "示例值示例值示例值",
          "CallIconVisibility": "DEFAULT"
        },
        "MaxTalkTime": 100,
        "CallingCallbackUrl": "http://aliyun.com"
      },
      "PhoneNumber": "861380000****",
      "StatusQueue": "alicom-0939****-queue",
      "IsOfficial": "N",
      "UpCallbackUrl": "https://www.alibaba.com/inbound\n"
    }
  ],
  "Message": "无",
  "RequestId": "90E63D28-E31D-1EB2-8939-A94866411B2O",
  "Code": "OK",
  "Success": true
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 Product.Unsubscript You have not subscribed to the specified product.
400 Ram.PermissionDeny You are not authorized to perform the operation.
400 System.LimitControl The system is under flow control.
400 Unknown.ResourceOwnerId The resource does not belong to the current user.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.