Início Rápido: Pesquisar informações do operador de um número de telefone usando Serviços de Comunicação do Azure

Artigo
04/11/2024

Importante

Este recurso dos Serviços de Comunicação do Azure estão atualmente em versão prévia.

Versões prévias das APIs e dos SDKs são fornecidas sem um contrato de nível de serviço. É recomendável que você não as use para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou talvez ter restrição de recursos.

Para saber mais, consulte os Termos de Uso Complementares das Versões Prévias do Microsoft Azure.

Introdução à biblioteca de clientes de Números de Telefone para JavaScript para pesquisar informações da operadora de números de telefone, que podem ser usadas para determinar se e como se comunicar com esse número de telefone. Siga estas etapas para instalar o pacote e pesquisar informações sobre o operador de um número de telefone.

Observação

Encontre o código deste guia de início rápido no GitHub.

Pré-requisitos

Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
Node.js versões de LTS ativo (suporte de longo prazo) e LTS de manutenção (8.11.1 e 10.14.1 recomendadas).
Um recurso e uma cadeia de conexão ativos dos Serviços de Comunicação. Crie um recurso dos Serviços de Comunicação.

Verificação de pré-requisitos

Em uma janela de comando ou do terminal, execute o comando node --version para verificar se o Node.js está instalado.

Configurando

Para configurar um ambiente para consultas de pesquisas, siga as etapas nas seções a seguir.

Criar um aplicativo Node.js

Em uma janela de comando ou do terminal, crie um novo diretório para seu aplicativo e navegue até ele.

mkdir number-lookup-quickstart && cd number-lookup-quickstart

Execute npm init -y para criar um arquivo package.json com as configurações padrão.

npm init -y

Crie um arquivo chamado number-lookup-quickstart.js na raiz do diretório que você criou. Adicione o seguinte snippet a ele:

async function main() {
    // quickstart code will go here
}

main();

Instalar o pacote

Use o comando npm install para instalar a biblioteca de clientes de Números de Telefone dos Serviços de Comunicação do Azure para JavaScript.

npm install @azure/communication-phone-numbers@1.3.0-beta.4 --save

A opção --save adiciona a biblioteca como uma dependência no arquivo package.json.

Exemplos de código

Autenticar o cliente

Importe o PhoneNumbersClient da biblioteca de clientes e instancie-o com sua cadeia de conexão, que pode ser adquirida de um recurso dos Serviços de Comunicação do Azure no portal do Azure. É recomendável usar uma variável de ambiente COMMUNICATION_SERVICES_CONNECTION_STRING para evitar colocar a cadeia de conexão em texto sem formatação no código. Saiba como gerenciar a cadeia de conexão do seu recurso.

Adicione o seguinte código à parte superior de number-lookup-quickstart.js:

const { PhoneNumbersClient } = require('@azure/communication-phone-numbers');

// This code retrieves your connection string from an environment variable
const connectionString = process.env['COMMUNICATION_SERVICES_CONNECTION_STRING'];

// Instantiate the phone numbers client
const phoneNumbersClient = new PhoneNumbersClient(connectionString);

Pesquisar a formatação do número de telefone

Para pesquisar informações do operador de um número de telefone, chame searchOperatorInformation de PhoneNumbersClient.

let formattingResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ]);

Substitua <target-phone-number> pelo número de telefone que você está procurando. Geralmente um número para o qual você gostaria de enviar uma mensagem.

Aviso

Forneça números de telefone no formato padrão internacional E.164, por exemplo, +14255550123.

Pesquisar informações do operador para um número

Para pesquisar informações do operador de um número de telefone, chame searchOperatorInformation do PhoneNumbersClient, passando true para a opção includeAdditionalOperatorDetails.

let searchResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ], { "includeAdditionalOperatorDetails": true });

Aviso

Usar essa funcionalidade incorrerá em um encargo para sua conta.

Usar informações do operador

Agora você pode usar as informações do operador. Para este guia de início rápido, podemos imprimir alguns dos detalhes no console.

Primeiro, podemos imprimir detalhes sobre o formato de número.

let formatInfo = formattingResults.values[0];
console.log(formatInfo.phoneNumber + " is formatted " + formatInfo.internationalFormat + " internationally, and " + formatInfo.nationalFormat + " nationally");

Em seguida, podemos imprimir detalhes sobre o número de telefone e o operador.

let operatorInfo = searchResults.values[0];
console.log(operatorInfo.phoneNumber + " is a " + (operatorInfo.numberType ? operatorInfo.numberType : "unknown") + " number, operated in "
    + operatorInfo.isoCountryCode + " by " + (operatorInfo.operatorDetails.name ? operatorInfo.operatorDetails.name : "an unknown operator"));

Você também pode usar as informações do operador para determinar se deseja enviar um SMS. Para obter mais informações sobre como enviar um SMS, consulte o Início Rápido do SMS.

Executar o código

Execute o aplicativo na janela de comando ou do terminal com o comando node.

node number-lookup-quickstart.js

Código de exemplo

É possível baixar o aplicativo de amostra do GitHub).

Introdução à biblioteca de clientes de números de telefone para C# para pesquisar informações de operador de números de telefone, que podem ser usados para determinar se e como se comunicar com esse número de telefone. Siga estas etapas para instalar o pacote e pesquisar informações sobre o operador de um número de telefone.

Observação

Encontre o código deste guia de início rápido no GitHub.

Pré-requisitos

Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
A versão mais recente da biblioteca de clientes do .NET Core para o seu sistema operacional.
Um recurso e uma cadeia de conexão ativos dos Serviços de Comunicação. Crie um recurso dos Serviços de Comunicação.

Verificação de pré-requisitos

Em um terminal ou em uma janela de comando, execute o comando dotnet para verificar se o SDK do .NET está instalado.

Configurando

Para configurar um ambiente para consultas de pesquisas, siga as etapas nas seções a seguir.

Criar um aplicativo em C#

Em uma janela de comando ou do terminal, execute o comando dotnet new para criar um novo aplicativo de console com o nome NumberLookupQuickstart. Esse comando cria um projeto simples em C# do tipo "Olá, Mundo" com um arquivo de origem único: Program.cs.

dotnet new console -o NumberLookupQuickstart

Altere o seu diretório para a pasta de aplicativo recém-criada e use o comando dotnet build para compilar o seu aplicativo.

cd NumberLookupQuickstart
dotnet build

Conectar-se ao feed de pacote de desenvolvimento

A versão de visualização pública do SDK é publicada em um feed de pacote de desenvolvimento. Você pode adicionar o feed de desenvolvimento usando a CLI do NuGet, que o adicionará ao arquivo NuGet.Config.

nuget sources add -Name "Azure SDK for .NET Dev Feed" -Source "https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-net/nuget/v3/index.json"

Informações mais detalhadas e outras opções para se conectar ao feed de desenvolvimento podem ser encontradas no guia de contribuição.

Instalar o pacote

Ainda no diretório do aplicativo, instale o pacote da biblioteca de clientes de Números de Telefone dos Serviços de Comunicação do Azure para .NET usando o comando a seguir.

dotnet add package Azure.Communication.PhoneNumbers --version 1.3.0-beta.5

Adicione uma diretiva using à parte superior de Program.cs para incluir o namespace Azure.Communication.

using System;
using System.Threading.Tasks;
using Azure.Communication.PhoneNumbers;

Atualize a assinatura de função Main para ser assíncrona.

internal class Program
{
    static async Task Main(string[] args)
    {
        ...
    }
}

Exemplos de código

Autenticar o cliente

Os clientes de Número de Telefone podem ser autenticados usando a cadeia de conexão adquirida do recurso dos Serviços de Comunicação do Azure no portal do Azure. É recomendável usar uma variável de ambiente COMMUNICATION_SERVICES_CONNECTION_STRING para evitar colocar a cadeia de conexão em texto sem formatação no código. Saiba como gerenciar a cadeia de conexão do seu recurso.

// This code retrieves your connection string from an environment variable.
string? connectionString = Environment.GetEnvironmentVariable("COMMUNICATION_SERVICES_CONNECTION_STRING");

PhoneNumbersClient client = new PhoneNumbersClient(connectionString, new PhoneNumbersClientOptions(PhoneNumbersClientOptions.ServiceVersion.V2024_03_01_Preview));

Os clientes de Número de Telefone também podem se autenticar com a autenticação do Microsoft Entra. Com essa opção, as variáveis de ambiente AZURE_CLIENT_SECRET, AZURE_CLIENT_ID e AZURE_TENANT_ID precisarão ser configuradas para autenticação.

// Get an endpoint to our Azure Communication Services resource.
Uri endpoint = new Uri("<endpoint_url>");
TokenCredential tokenCredential = new DefaultAzureCredential();
client = new PhoneNumbersClient(endpoint, tokenCredential);

Pesquisar a formatação do número de telefone

Para pesquisar a formatação nacional e internacional de um número, chame SearchOperatorInformationAsync do PhoneNumbersClient.

OperatorInformationResult formattingResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" });

Substitua <target-phone-number> pelo número de telefone que você está procurando. Geralmente um número para o qual você gostaria de enviar uma mensagem.

Aviso

Forneça números de telefone no formato padrão internacional E.164, por exemplo, +14255550123.

Pesquisar informações do operador para um número

Para pesquisar informações do operador de um número de telefone, chame SearchOperatorInformationAsync do PhoneNumbersClient, passando true para a opção IncludeAdditionalOperatorDetails.

OperatorInformationResult searchResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" }, new OperatorInformationOptions() { IncludeAdditionalOperatorDetails = true });

Aviso

Usar essa funcionalidade incorrerá em um encargo para sua conta.

Usar informações do operador

Agora você pode usar as informações do operador. Para este guia de início rápido, podemos imprimir alguns dos detalhes no console.

Primeiro, podemos imprimir detalhes sobre o formato de número.

OperatorInformation formattingInfo = formattingResult.Values[0];
Console.WriteLine($"{formattingInfo.PhoneNumber} is formatted {formattingInfo.InternationalFormat} internationally, and {formattingInfo.NationalFormat} nationally");

Em seguida, podemos imprimir detalhes sobre o número de telefone e o operador.

OperatorInformation operatorInformation = searchResult.Values[0];
Console.WriteLine($"{operatorInformation.PhoneNumber} is a {operatorInformation.NumberType ?? "unknown"} number, operated in {operatorInformation.IsoCountryCode} by {operatorInformation.OperatorDetails.Name ?? "an unknown operator"}");

Você também pode usar as informações do operador para determinar se deseja enviar um SMS. Para obter mais informações sobre como enviar um SMS, consulte o Início Rápido do SMS.

Executar o código

Execute o aplicativo na janela de comando ou do terminal com o comando dotnet run.

dotnet run --interactive

Código de exemplo

É possível baixar o aplicativo de exemplo do GitHub.

Introdução à biblioteca de clientes de Números de Telefone para Java para pesquisar informações da operadora de números de telefone, que podem ser usadas para determinar se e como se comunicar com esse número de telefone. Siga estas etapas para instalar o pacote e pesquisar informações sobre o operador de um número de telefone.

Observação

Encontre o código deste guia de início rápido no GitHub.

Pré-requisitos

Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
JDK (Java Development Kit) versão 8 ou superior.
Apache Maven.
Um recurso e uma cadeia de conexão ativos dos Serviços de Comunicação. Crie um recurso dos Serviços de Comunicação.

Verificação de pré-requisitos

Em um terminal ou em uma janela de comando, execute o comando mvn -v para verificar se o Maven está instalado.

Configurando

Para configurar um ambiente para consultas de pesquisas, siga as etapas nas seções a seguir.

Criar um aplicativo Java

Em uma janela de comando ou do terminal, navegue até o diretório no qual você deseja criar o seu aplicativo Java. Execute o comando abaixo para gerar o projeto Java a partir do modelo maven-archetype-quickstart.

mvn archetype:generate -DgroupId=com.communication.lookup.quickstart -DartifactId=communication-lookup-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

A tarefa ''gerar'' cria um diretório com o mesmo nome do artifactId. Nesse diretório, o diretório src/main/java contém o código-fonte do projeto, o src/test/java directory contém a fonte de teste e o arquivo pom.xml é o Modelo de Objeto do Projeto, ou POM.

Conectar-se ao feed de pacote de desenvolvimento

A versão de visualização pública do SDK é publicada em um feed de pacote de desenvolvimento. Para se conectar ao feed de desenvolvimento, abra o arquivo pom.xml no editor de texto e adicione o repositório de desenvolvimento para ambas as seções <repositories> e <distributionManagement> do pom.xml que podem ser adicionadas, se ainda não existirem.

<repository>
  <id>azure-sdk-for-java</id>
  <url>https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-java/maven/v1</url>
  <releases>
    <enabled>true</enabled>
  </releases>
  <snapshots>
    <enabled>true</enabled>
  </snapshots>
</repository>

Talvez seja necessário adicionar ou editar o arquivo settings.xml no ${user.home}/.m2

<server>
  <id>azure-sdk-for-java</id>
  <username>azure-sdk</username>
  <password>[PERSONAL_ACCESS_TOKEN]</password>
</server>

Você pode gerar um Token de acesso pessoal com escopos de leitura e gravação de Empacotamento e colá-lo na marca <password>.

Informações mais detalhadas e outras opções para se conectar ao feed de desenvolvimento podem ser encontradas aqui.

Instalar o pacote

Adicione os seguintes elementos de dependência ao grupo de dependências no arquivo pom.xml.

<dependencies>
  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-common</artifactId>
    <version>1.0.0</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-phonenumbers</artifactId>
    <version>1.2.0-beta.3</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>1.2.3</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-core</artifactId>
    <version>1.41.0</version>
  </dependency>
</dependencies>

Verifique a seção properties para garantir que seu projeto tenha como destino o Maven versão 1.8 ou superior.

<properties>
  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  <maven.compiler.source>1.8</maven.compiler.source>
  <maven.compiler.target>1.8</maven.compiler.target>
</properties>

Exemplos de código

Configurar o framework de aplicativos

No diretório do projeto:

Navegue até o diretório /src/main/java/com/communication/lookup/quickstart
Abra o arquivo App.java em seu editor
Substitua a instrução System.out.println("Hello world!");
Adicione diretivas import

Use o seguinte código para começar:

package com.communication.lookup.quickstart;

import com.azure.communication.phonenumbers.*;
import com.azure.communication.phonenumbers.models.*;
import com.azure.core.http.rest.*;
import com.azure.core.util.Context;
import com.azure.identity.*;
import java.io.*;
import java.util.ArrayList;

public class App
{
    public static void main( String[] args ) throws IOException
    {
        System.out.println("Azure Communication Services - Number Lookup Quickstart");
        // Quickstart code goes here
    }
}

Autenticar o cliente

O cliente poderá ser autenticado usando uma cadeia de conexão adquirida de um recurso dos Serviços de Comunicação do Azure no portal do Azure. É recomendável usar uma variável de ambiente COMMUNICATION_SERVICES_CONNECTION_STRING para evitar colocar a cadeia de conexão em texto sem formatação no código. Saiba como gerenciar a cadeia de conexão do seu recurso.

// This code retrieves your connection string from an environment variable
String connectionString = System.getenv("COMMUNICATION_SERVICES_CONNECTION_STRING");

PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
    .connectionString(connectionString)
    .buildClient();

Como alternativa, você pode autenticar usando a autenticação do Microsoft Entra. Usar o DefaultAzureCredentialBuilder é a maneira mais fácil de começar a usar o Microsoft Entra ID. Você pode adquirir o nome do recurso de um recurso de Serviços de Comunicação do Azure no portal do Azure.

// You can find your resource name from your resource in the Azure portal
String endpoint = "https://<RESOURCE_NAME>.communication.azure.com";

PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
    .endpoint(endpoint)
    .credential(new DefaultAzureCredentialBuilder().build())
    .buildClient();

Pesquisar a formatação do número de telefone

Para pesquisar a formatação nacional e internacional de um número, chame searchOperatorInformation do PhoneNumbersClient.

ArrayList<String> phoneNumbers = new ArrayList<String>();
phoneNumbers.add("<target-phone-number>");

// Use the free number lookup functionality to get number formatting information
OperatorInformationResult formattingResult = phoneNumberClient.searchOperatorInformation(phoneNumbers);
OperatorInformation formattingInfo = formattingResult.getValues().get(0);

Substitua <target-phone-number> pelo número de telefone que você está procurando. Geralmente um número para o qual você gostaria de enviar uma mensagem.

Aviso

Forneça números de telefone no formato padrão internacional E.164, por exemplo, +14255550123.

Pesquisar informações do operador para um número

Para pesquisar informações do operador de um número de telefone, chame searchOperatorInformationWithResponse do PhoneNumbersClient, passando true para a opção IncludeAdditionalOperatorDetails.

OperatorInformationOptions options = new OperatorInformationOptions();
options.setIncludeAdditionalOperatorDetails(true);
Response<OperatorInformationResult> result = phoneNumberClient.searchOperatorInformationWithResponse(phoneNumbers, options, Context.NONE);
OperatorInformation operatorInfo = result.getValue().getValues().get(0);

Aviso

Usar essa funcionalidade incorrerá em um encargo para sua conta.

Usar informações do operador

Agora você pode usar as informações do operador. Para este guia de início rápido, podemos imprimir alguns dos detalhes no console.

Primeiro, podemos imprimir detalhes sobre o formato de número.

System.out.println(formattingInfo.getPhoneNumber() + " is formatted "
    + formattingInfo.getInternationalFormat() + " internationally, and "
    + formattingInfo.getNationalFormat() + " nationally");

Em seguida, podemos imprimir detalhes sobre o número de telefone e o operador.

String numberType = operatorInfo.getNumberType() == null ? "unknown" : operatorInfo.getNumberType().toString();
String operatorName = "an unknown operator";
if (operatorInfo.getOperatorDetails()!= null && operatorInfo.getOperatorDetails().getName() != null)
{
    operatorName = operatorInfo.getOperatorDetails().getName();
}
System.out.println(operatorInfo.getPhoneNumber() + " is a " + numberType + " number, operated in "
    + operatorInfo.getIsoCountryCode() + " by " + operatorName);

Você também pode usar as informações do operador para determinar se deseja enviar um SMS. Para obter mais informações sobre como enviar um SMS, consulte o Início Rápido do SMS.

Executar o código

Execute o aplicativo na janela de comando ou do terminal com os seguintes comandos: Navegue até o diretório que contém o arquivo pom.xml e compile o projeto.

mvn compile

Em seguida, compile o pacote.

mvn package

Para executar o aplicativo, use o comando mvn.

mvn exec:java -D"exec.mainClass"="com.communication.lookup.quickstart.App" -D"exec.cleanupDaemonThreads"="false"

Código de exemplo

É possível baixar o aplicativo de exemplo do GitHub.

Introdução à biblioteca de clientes de Números de Telefone para Python para pesquisar informações da operadora de números de telefone, que podem ser usadas para determinar se e como se comunicar com esse número de telefone. Siga estas etapas para instalar o pacote e pesquisar informações sobre o operador de um número de telefone.

Observação

Encontre o código deste guia de início rápido no GitHub.

Pré-requisitos

Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
Python 3.7+.
Um recurso e uma cadeia de conexão ativos dos Serviços de Comunicação. Crie um recurso dos Serviços de Comunicação.

Verificação de pré-requisitos

Em um terminal ou em uma janela de comando, execute o comando python --version para verificar se o Python está instalado.

Configurando

Para configurar um ambiente para consultas de pesquisas, siga as etapas nas seções a seguir.

Criar um novo aplicativo Python

Em uma janela de comando ou do terminal, crie um novo diretório para seu aplicativo e navegue até ele.

mkdir number-lookup-quickstart && cd number-lookup-quickstart

Use um editor de texto para criar um arquivo chamado number_lookup_sample.py no diretório raiz do projeto e adicione o código a seguir. O código de início rápido restante é adicionado nas seções a seguir.

import os
from azure.communication.phonenumbers import PhoneNumbersClient

try:
   print('Azure Communication Services - Number Lookup Quickstart')
   # Quickstart code goes here
except Exception as ex:
   print('Exception:')
   print(ex)

Instalar o pacote

Ainda no diretório do aplicativo, instale a biblioteca de clientes PhoneNumbers dos Serviços de Comunicação do Azure para o pacote Python usando o comando pip install.

pip install azure-communication-phonenumbers==1.2.0b2

Exemplos de código

Autenticar o cliente

# This code retrieves your connection string from an environment variable
connection_string = os.getenv('COMMUNICATION_SERVICES_CONNECTION_STRING')
try:
    phone_numbers_client = PhoneNumbersClient.from_connection_string(connection_string)
except Exception as ex:
    print('Exception:')
    print(ex)

Como alternativa, o cliente poderá ser autenticado usando a autenticação do Microsoft Entra. Usar o objeto DefaultAzureCredential é a maneira mais fácil de começar a usar o Microsoft Entra ID e você pode instalá-lo usando o comando pip install.

pip install azure-identity

A criação de um objeto DefaultAzureCredential requer que você já tenha AZURE_CLIENT_ID, AZURE_CLIENT_SECRET e AZURE_TENANT_ID definidos como variáveis de ambiente com seus valores correspondentes do aplicativo Microsoft Entra registrado.

Para saber mais sobre como obter essas variáveis de ambiente, você pode aprender a configurar entidades de serviço na CLI.

Depois que a biblioteca de azure-identity for instalada, você poderá continuar autenticando o cliente.

from azure.identity import DefaultAzureCredential

# You can find your endpoint from your resource in the Azure portal
endpoint = 'https://<RESOURCE_NAME>.communication.azure.com'
try:
    credential = DefaultAzureCredential()
    phone_numbers_client = PhoneNumbersClient(endpoint, credential)
except Exception as ex:
    print('Exception:')
    print(ex)

Pesquisar a formatação do número de telefone

Para pesquisar a formatação nacional e internacional de um número, chame search_operator_information do PhoneNumbersClient.

formatting_results = phone_numbers_client.search_operator_information("<target-phone-number>")

Substitua <target-phone-number> pelo número de telefone que você está procurando. Geralmente um número para o qual você gostaria de enviar uma mensagem.

Aviso

Forneça números de telefone no formato padrão internacional E.164, por exemplo, +14255550123.

Pesquisar informações do operador para um número

Para pesquisar informações do operador de um número de telefone, chame search_operator_information do PhoneNumbersClient, passando True para a opção include_additional_operator_details.

options = { "include_additional_operator_details": True }
operator_results = phone_numbers_client.search_operator_information("<target-phone-number>", options)

Aviso

Usar essa funcionalidade incorrerá em um encargo para sua conta.

Usar informações do operador

Agora você pode usar as informações do operador. Para este guia de início rápido, podemos imprimir alguns dos detalhes no console.

Primeiro, podemos imprimir detalhes sobre o formato de número.

formatting_info = formatting_results.values[0]
print(str.format("{0} is formatted {1} internationally, and {2} nationally", formatting_info.phone_number, formatting_info.international_format, formatting_info.national_format))

Em seguida, podemos imprimir detalhes sobre o número de telefone e o operador.

operator_information = operator_results.values[0]

number_type = operator_information.number_type if operator_information.number_type else "unknown"
if operator_information.operator_details is None or operator_information.operator_details.name is None:
    operator_name = "an unknown operator"
else:
    operator_name = operator_information.operator_details.name

print(str.format("{0} is a {1} number, operated in {2} by {3}", operator_information.phone_number, number_type, operator_information.iso_country_code, operator_name))

Você também pode usar as informações do operador para determinar se deseja enviar um SMS. Para obter mais informações sobre como enviar um SMS, consulte o Início Rápido do SMS.

Executar o código

Execute o aplicativo na janela de comando ou do terminal com o comando python.

python number_lookup_sample.py

Código de exemplo

É possível baixar o aplicativo de exemplo do GitHub.

Solução de problemas

Perguntas e problemas comuns:

As alterações nas variáveis de ambiente podem não ter efeito em programas que já estejam em execução. Se você observar que as variáveis de ambiente não estão funcionando conforme o esperado, tente fechar e reabrir todos os programas que estiver usando para executar e editar código.
Os dados retornados por esse ponto de extremidade estão sujeitos a várias leis e regulamentos internacionais, portanto, a precisão dos resultados depende de vários fatores. Esses fatores incluem se o número foi portado, o código do país e o status de aprovação do chamador. Com base nesses fatores, as informações do operador podem não estar disponíveis para alguns números de telefone ou podem refletir o operador original do número de telefone, não o operador atual.

Próximas etapas

Neste guia de início rápido, você aprendeu a:

Pesquisar a formatação de número
Pesquisar informações do operador para um número de telefone

Conceito de Pesquisa de Número

SDK de Pesquisa de Número

Compartilhar via

Início Rápido: Pesquisar informações do operador de um número de telefone usando Serviços de Comunicação do Azure

Pré-requisitos

Verificação de pré-requisitos

Configurando

Criar um aplicativo Node.js

Instalar o pacote

Exemplos de código

Autenticar o cliente

Pesquisar a formatação do número de telefone

Pesquisar informações do operador para um número

Usar informações do operador

Executar o código

Código de exemplo

Pré-requisitos

Verificação de pré-requisitos

Configurando

Criar um aplicativo em C#

Conectar-se ao feed de pacote de desenvolvimento

Instalar o pacote

Exemplos de código

Autenticar o cliente

Pesquisar a formatação do número de telefone

Pesquisar informações do operador para um número

Usar informações do operador

Executar o código

Código de exemplo

Pré-requisitos

Verificação de pré-requisitos

Configurando

Criar um aplicativo Java

Conectar-se ao feed de pacote de desenvolvimento

Instalar o pacote

Exemplos de código

Configurar o framework de aplicativos

Autenticar o cliente

Pesquisar a formatação do número de telefone

Pesquisar informações do operador para um número

Usar informações do operador

Executar o código

Código de exemplo

Pré-requisitos

Verificação de pré-requisitos

Configurando

Criar um novo aplicativo Python

Instalar o pacote

Exemplos de código

Autenticar o cliente

Pesquisar a formatação do número de telefone

Pesquisar informações do operador para um número

Usar informações do operador

Executar o código

Código de exemplo

Solução de problemas

Próximas etapas

Comentários

Recursos adicionais