Identificações de Remetente

A API para validação de identificações de remetente permite validar números de telefone para uso como remetente. Após chamar esta API, você receberá um código de retorno em caso de sucesso. Simultaneamente, o número de telefone especificado receberá uma chamada nossa. Neste momento, o código retornado deve ser inserido através do teclado do telefone via DTMF.

Validar remetente

Para usar um número de telefone como remetente, você deve primeiro validá-lo. Para isso, você receberá uma chamada na qual um código deve ser inserido. Em caso de sucesso e se o número ainda não tiver sido validado para sua conta, você receberá um objeto JSON com o código de retorno.

Parâmetros

Name
number
Type
string
Description
O número de telefone a ser validado. O formato é quase irrestrito – nosso gateway formata o número automaticamente de forma correta.

Parâmetros Opcionais

Name
callback
Type
string
Description
URL de callback que deve ser chamada assim que a validação for realizada com sucesso.

Requisição

POST

/api/validate_for_voice

curl -G https://gateway.seven.io/api/validate_for_voice \
    -H "X-Api-Key: SUA_CHAVE_API" \
    -H "Accept: application/json"
    -d "number=49176123456789"

Resposta em caso de sucesso

{
    "code": "699350",
    "error": null,
    "success": true
}

Resposta se o número for inválido

{
    "id": null,
    "sender": "49176123456789",
    "formatted_output": null,
    "success": false,
    "error": "Empfängernummer ungültig",
    "voice": false
}

Resposta se o número já estiver validado

{
    "id": 12345,
    "sender": "49176123456789",
    "formatted_output": "+49 176 123456789",
    "success": true,
    "error": "Die Absenderkennung ist bereits gespeichert.",
    "voice": true
}