Cómo enviar SMS desde C# y .NET con la API de Grupo Tecnophone

Enviar un SMS con C# y HttpClient

El siguiente programa de consola envía un SMS y procesa la respuesta:

using System.Net.Http.Headers;
using System.Net.Http.Json;
using System.Text.Json;

var token = Environment.GetEnvironmentVariable("GTP_SMS_TOKEN")
    ?? throw new InvalidOperationException("Falta la variable GTP_SMS_TOKEN");

using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
http.DefaultRequestHeaders.UserAgent.ParseAdd("MiEmpresa/1.0");

var payload = new
{
    to = "+525512345678",
    body = "Su codigo de verificacion es 482913. Vence en 5 minutos."
};

using var response = await http.PostAsJsonAsync(
    "https://api.grupotecnophone.com/prod/v1/sms/send", payload);

var json = await response.Content.ReadAsStringAsync();
using var doc = JsonDocument.Parse(json);
var root = doc.RootElement;

if (response.IsSuccessStatusCode
    && root.TryGetProperty("status", out var status)
    && status.GetString() == "success")
{
    Console.WriteLine($"Enviado. SID: {root.GetProperty("sid").GetString()} - segmentos: {root.GetProperty("num_segments").GetInt32()}");
}
else
{
    var code = root.TryGetProperty("error", out var error) && error.ValueKind == JsonValueKind.Object
        ? error.GetProperty("code").GetString()
        : $"HTTP_{(int)response.StatusCode}";
    Console.WriteLine($"No enviado ({code}): {json}");
}

Enviar SMS a varios destinatarios con C#

Para enviar SMS masivos desde .NET conviene encapsular la llamada en una clase y reutilizar el mismo HttpClient. Así guarda el sid de cada mensaje y separa los errores.

using System.Net.Http.Json;
using System.Text.Json;

public sealed record SmsResult(bool Ok, string? Sid, string? Error);

public sealed class GtpSmsClient
{
    private const string Endpoint = "https://api.grupotecnophone.com/prod/v1/sms/send";
    private readonly HttpClient _http;

    // Reciba un HttpClient ya configurado con el token, el User-Agent y el timeout
    public GtpSmsClient(HttpClient http) => _http = http;

    public async Task<SmsResult> SendAsync(string to, string body, CancellationToken ct = default)
    {
        using var response = await _http.PostAsJsonAsync(Endpoint, new { to, body }, ct);
        var json = await response.Content.ReadAsStringAsync(ct);
        try
        {
            using var doc = JsonDocument.Parse(json);
            var root = doc.RootElement;
            if (response.IsSuccessStatusCode
                && root.TryGetProperty("status", out var s) && s.GetString() == "success")
            {
                return new SmsResult(true, root.GetProperty("sid").GetString(), null);
            }
            var code = root.TryGetProperty("error", out var e) && e.ValueKind == JsonValueKind.Object
                ? e.GetProperty("code").GetString()
                : null;
            return new SmsResult(false, null, code ?? $"HTTP_{(int)response.StatusCode}");
        }
        catch (JsonException)
        {
            return new SmsResult(false, null, $"HTTP_{(int)response.StatusCode}");
        }
    }
}

// Uso: recorrer la lista a un ritmo moderado y guardar el sid de cada mensaje
var sms = new GtpSmsClient(http);
string[] destinatarios = { "+525512345678", "+528112345678" };

foreach (var numero in destinatarios)
{
    var r = await sms.SendAsync(numero, "Su pedido fue enviado. Gracias por su compra.");
    Console.WriteLine(r.Ok ? $"{numero}: {r.Sid}" : $"{numero}: error {r.Error}");
    await Task.Delay(200);
}

En ASP.NET Core registre la clase con builder.Services.AddHttpClient<GtpSmsClient>() y configure ahí el token, el User-Agent y el timeout. Para volúmenes altos, encole los envíos en un servicio en segundo plano. Sin programar, también puede enviar SMS masivos desde Excel o CSV.

Errores frecuentes

En los errores 400 la respuesta incluye un objeto error con code, code_num y message.

Buenas prácticas

• Defina un timeout y registre cada respuesta con su sid.
• Ante un error de red sin respuesta, no reenvíe a ciegas: verifique primero para no duplicar el mensaje al usuario.
• Reintente solo errores 500, con espera progresiva y un número máximo de intentos.
• Encole los envíos masivos en lugar de enviarlos en el ciclo de una petición web.
• Si el contenido es sensible, active el cifrado de la conexión; la documentación de la API describe el formato de cifrado RSA-OAEP.

Vea también la API SMS México, la conexión SMPP y las guías para PHP, Laravel, Python, Node.js, Java y cURL. Si necesita credenciales de prueba, contáctenos.