Pradžia

Kūrimas su PureSMS negali būti paprastesnis naudojant mūsų REST API arba oficialias klientų bibliotekas.

PureSMS sukurtas tiesiogiai ant divergent Connect, todėl naudosite Connect API tiesiogiai sąveikai su platforma. Tai padarėme tam, kad jūsų programai augant nereikėtų daug keisti, norint pereiti į Connect ir naudoti pažangesnes funkcijas.

Nustatymas

Norėdami pradėti, turėsite tinkamai nustatyti Connect.

Sukurkite darbo erdvę PureSMS.
Atidaryti PureSMS
Jei nesate aktyvūs, įsitikinkite, kad patvirtinote savo testinį numerį, kad galėtumėte siųsti iš „ConnectTest”.

Atkreipkite dėmesį, kad testiniame režime šiuo metu palaikomi tik JK numeriai.

Kur tai padaryti?
PureSMS viduje paspauskite „Nustatymai” viršutinėje navigacijoje, tada „Testinis režimas” kairėje.
Jei esate aktyvūs (arba planuojate netrukus pradėti), pridėkite bent vieną siuntėjo vardą prie savo darbo erdvės ir šalį, į kurią siųsite.

Kur tai padaryti?
PureSMS viduje paspauskite „Siuntėjai” viršutinėje navigacijoje, tada „Sukurti siuntėją” viršuje dešinėje.
Jūsų bus paprašyta nurodyti siuntėjo vardą, pavyzdinį turinį ir bent 1 šalį siuntėjo registracijai.

Siuntėjų vardai bus patvirtinti PureSMS net ir testavimo metu. Pabandykite pridėti tikrą siuntėjo vardą, kurį naudosite ateityje.
Sužinokite daugiau apie siuntėjus
Pridėkite naują API raktą prie savo darbo erdvės.

Kur tai padaryti?
PureSMS viduje paspauskite „Nustatymai” viršutinėje navigacijoje, tada „API raktai” kairėje. Tada galite paspausti „Pridėti API raktą” viršuje dešinėje.
🎉 Pasiruošę.

Pirmosios SMS siuntimas

Pasirinkite norimą būdą išsiųsti pirmąją SMS.

Įdiegimas

Įdiekite Divergent.Connect paketą iš NuGet:

dotnet add package Divergent.Connect

Nustatymas

Pasirinkite nustatymo būdą, kuris geriausiai tinka jūsų programai:

var builder = WebApplication.CreateBuilder(args);

// Pridėti Connect klientą
builder.AddDivergentConnect();

var app = builder.Build();

Pridėkite konfigūraciją į appsettings.json:

{
  "Divergent": {
    "Connect": {
      "ApiKey": "jūsų-api-raktas",
      "DefaultSmsSender": "JūsųSiuntėjas"
    }
  }
}

public void ConfigureServices(IServiceCollection services)
{
    services.AddDivergentConnect(Configuration);
}

Pridėkite konfigūraciją į appsettings.json:

{
  "Divergent": {
    "Connect": {
      "ApiKey": "jūsų-api-raktas",
      "DefaultSmsSender": "JūsųSiuntėjas"
    }
  }
}

using Divergent.Connect;

var smsClient = new ConnectClientBuilder()
    .WithApiKey("jūsų-api-raktas")
    .WithDefaultSmsSender("JūsųSiuntėjas")
    .BuildSmsClient();

Išsiųskite pirmąją SMS

// Įterpkite IConnectSms į savo paslaugą/valdiklį (arba naudokite rankiniu būdu sukurtą klientą)
public class MyService(IConnectSms smsClient)
{
    public async Task SendWelcomeSms(string phoneNumber)
    {
        await smsClient.SendSmsAsync(new ConnectSmsMessage
        {
            To = phoneNumber,       // E.164 formatas, pvz. "+37060000000"
            Content = "Sveikas pasauli, iš PureSMS!"
        });
    }
}

Įdiegimas

Įdiekite @divergent/connect paketą iš npm:

npm install @divergent/connect

Išsiųskite pirmąją SMS

import { ConnectClient } from '@divergent/connect';

const client = new ConnectClient({
  apiKey: process.env.DIVERGENT_CONNECT_API_KEY,
  defaultSmsSender: 'JūsųSiuntėjas'
});

const result = await client.sms.send({
  to: '+37060000000',  // E.164 formatas
  content: 'Sveikas pasauli, iš PureSMS!'
});

console.log('SMS išsiųsta! ID:', result.id);

Įklijuokite tai į savo mėgstamą terminalą, kad išsiųstumėte pirmąją SMS. Nepamirškite pakeisti vietos žymeklių.

curl -X POST https://connect-api.divergent.cloud/sms/send \
  -H "X-Api-Key: { API_KEY }" \
  --json '{
    "sender": "{ SENDER_NAME }",
    "recipient": "{ RECIPIENT_NUMBER }",
    "content": "Sveikas pasauli, iš PureSMS!"
  }'