restauro em massa da v3
O objetivo desta função de API é restaurar números de telefone em massa. POST: https://api.multitel.net/v3/bulk_restore - Autenticação: HTTP basic com as credenciais de API do usuário. - Corpo (application/json): {
"numbers":
[
"15551230111",
"15551230112",
"15551230113"
],
"webhook_url": "https://client.example.com/restore-hook"
} - Aceita cadeias contendo somente dígitos; numbers_text (separado por quebras de linha) também funciona. - 10 números ou menos → processados de forma síncrona; mais de 10 → enfileirados e processados por um service worker. - Resposta síncrona (possível somente se 10 números ou menos forem fornecidos): {
"job_uuid": "8f6c1f0e-23d2-4717-8c8e-1a518e5738f0",
"status": "completed",
"total_numbers": 3,
"success_count": 1,
"failure_count": 2,
"webhook_url": "https://client.example.com/restore-hook",
"created_at": "2025-10-28 12:31:45",
"started_at": "2025-10-28 12:31:45",
"completed_at": "2025-10-28 12:31:48",
"results": [
{
"number": "15551230111",
"status": "success",
"message": "Number restored",
"status_code": 200,
"requires_identity_update": 0
},
{
"number": "15551230112",
"status": "failed",
"message": "Error: 'restore failed, please contact support'",
"status_code": 500,
"requires_identity_update": 0
},
{
"number": "15551230113",
"status": "success",
"message": "Number restored",
"status_code": 200,
"requires_identity_update": 1,
"needs_registration": 1
}
]
} Caso ocorram erros no processamento do payload (timeouts, domínio não resolvido no DNS etc.), os erros serão retornados após o array “results”: "webhook_error":"Could not resolve host: asidhaiufsd0uf.multitel.net" OU, se mais de 10 números tiverem sido fornecidos: - Enfileirado (202 Accepted): {
"job_uuid": "c5bc4f3a-7b0a-4d5d-9f7e-d3fd87f41a00",
"status": "pending",
"total_numbers": 25,
"webhook_url": "https://client.example.com/restore-hook",
"message": "Restore job queued. Results will be POSTed to https://client.example.com/restore-hook"
} - O payload do webhook é idêntico à estrutura síncrona final (incluindo códigos/mensagens de status por número). Consulta de status - GET https://api.multitel.net/v3/bulk_restore_status - job_uuid obrigatório, number opcional (somente dígitos). - A resposta reflete o resumo do trabalho com o estado atual por número, além de tentativas e carimbos de data/hora; o filtro por número retorna apenas essa entrada. - Exemplo: GET …/bulk_restore_status?job_uuid=8f6c1f0e-23d2-4717-8c8e-1a518e5738f0 - Filtrado: GET …/bulk_restore_status?job_uuid=…&number=15551230113 - GET https://api.multitel.net/v3/bulk_restore_status - Autenticação: o mesmo HTTP Basic das outras chamadas v3. - Parâmetros de consulta: - job_uuid (obrigatório) – retornado na resposta POST. - number (opcional) – somente dígitos; restringe os resultados a um único DID. - A resposta reflete o payload do webhook e agora inclui requires_identity_update (1/0) mais needs_registration quando aplicável. Exemplo: {
"job_uuid": "8f6c1f0e-23d2-4717-8c8e-1a518e5738f0",
"status": "processing",
"total_numbers": 25,
"success_count": 10,
"failure_count": 0,
"webhook_url": "https://client.example.com/restore-hook",
"created_at": "2025-10-28 12:31:45",
"started_at": "2025-10-28 12:31:45",
"completed_at": null,
"results": [
{
"number": "15551230111",
"status": "success",
"message": "Number restored",
"status_code": 200,
"attempts": 1,
"started_at": "2025-03-28 12:31:45",
"completed_at": "2025-03-28 12:31:47",
"requires_identity_update": 0
},
{
"number": "15551230112",
"status": "failed",
"message": "Error: 'restore failed, please contact support'",
"status_code": 500,
"attempts": 1,
"started_at": "2025-03-28 12:31:45",
"completed_at": "2025-03-28 12:31:46",
"requires_identity_update": 0
},
{
"number": "15551230113",
"status": "success",
"message": "Number restored",
"status_code": 200,
"attempts": 1,
"started_at": "2025-03-28 12:31:45",
"completed_at": "2025-03-28 12:31:48",
"requires_identity_update": 1,
"needs_registration": 1
}
]
} - Com number=15551230113, o array de resultados conterá somente essa entrada mais filtered_number no payload. Se você quiser criar sua própria função de restauração em massa, poderá usar o endpoint de API de número único abaixo e chamá-lo repetidamente, para cada número que desejar restaurar.
curl -u 'USERNAME:PASSWORD' \
-H 'Accept: application/json' \
https://api.multitel.net/v3/restore/447000123456