Especificação da API Obter token

O engajamento envia uma solicitação HTTP POST ao URI para o servidor de token que você fornece como parte de um processo de envio de token. Essa solicitação contém uma lista de valores de token e o servidor de token responde com a lista de valores de token e os tokens associados.

Se a solicitação for enviada sem um token, o JSON de resposta na matriz de tokens não conterá dados. Se houver apenas um único tokenValue na solicitação e seu servidor de token não fornecer um token para ela, a resposta incluirá uma matriz vazia para a propriedade de tokens na resposta JSON.

A API obtém a representação de token dos dados de número de telefone. O token é armazenado no banco de dados em vez do número de telefone de origem de uma mensagem SMS de entrada.

Pré-requisitos

Ative SSL no ponto de extremidade. Use a autenticação de credenciais de cliente básicas ou OAuth com a lista de permissões de IP no lado do servidor para autenticar chamadas de clientes.

Formato do corpo de solicitação JSON

O Marketing Cloud Engagement envia uma solicitação usando o tipo de conteúdo application/json com o corpo contendo uma matriz obrigatória de valores de token chamada tokenValues. Cada objeto tokenValue na matriz contém estas propriedades.

Exemplo de solicitação JSON tokenValues

{
  "tokenValues": [
    {
      "tokenRequestId": "abc123thn567",
      "tokenValue": "13172237777",
      "tokenType": "MobileNumber",
      "privateCode": "46356",
    },
    {
      "tokenRequestId": "abc098thn654",
      "tokenValue": "13175559911",
      "tokenType": "MobileNumber",
      "privateCode": "45356",
    }
  ]
}

Formato do corpo de resposta JSON

A resposta retornada em um bloco de tipo de conteúdo aplicativo/json inclui um código de status HTTP.

Corpo e objeto de token

Considerações sobre o MobileConnect

Os tokens mantêm um relacionamento de um para um com números de telefone. Os tokens de número de telefone usam o mesmo valor de token mesmo que o mesmo número de telefone celular apareça para vários contatos. Caso pretenda usar Envios acionados (API messageContact), forneça o país real à frente do token de celular. O valor inteiro não pode exceder 15 caracteres.

Exemplo de resposta

{
  "tokens": [
    {
      "tokenRequestId": "abc123thn567",
      "token": "999911112222",
	"subscriberKey": "abc123456xyz”
    },
    {
      "tokenRequestId": "abc098thn654",
      "token": "999911112233",
	"subscriberKey": "123abcxyz456”
    }
  ]
}