SDK Node.js

npm install @messageglobe/sdk

import { MessageGlobe } from '@messageglobe/sdk'; const mg = new MessageGlobe({  // Copia il tuo token dalla dashboard sviluppatori.  // Un solo token abilita tutte le funzioni REST.  apiToken: 'XX|xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',  smtp: {    host: 'smtp.messageglobe.com',    port: 587,    fromAddress: '[email protected]',    fromName: 'YourApp',    username: 'smtp-user',    password: 'smtp-password',    encryption: 'tls',  },}); // Invia un SMSconst response = await mg.sms.send({  to: '393612345678',  from: 'YourName',  message: 'This is a test message',  gateway: 'HQ',});console.log(response.messageId); // Crea un contattoconst contact = await mg.contacts.create('list_uid_example', { phone: '393310000000' });console.log(contact.uid); // Invia una emailawait mg.email.send({  to: { email: '[email protected]', name: 'Jane Doe' },  subject: 'Welcome',  html: '<h1>Hi Jane</h1>',  text: 'Hi Jane',});

import { SmsClient } from '@messageglobe/sdk'; const client = new SmsClient({ apiToken: 'XX|your-api-token' }); // Lingua delle risposte API: "en" oppure "it".const italian = new SmsClient({ apiToken: 'XX|your-api-token', acceptLanguage: 'it' }); // CommonJS è supportato allo stesso modo:// const { MessageGlobe } = require('@messageglobe/sdk');

const response = await client.send({  to: '393612345678',        // un numero, "n1,n2" oppure un array  from: 'YourName',          // sender ID, max 11 caratteri se alfanumerico  message: 'Hello world',  gateway: 'HQ',  dlrCallbackUrl: 'https://yourapp.com/webhooks/dlr', // opzionale, solo HQ}); const [result] = response.results;console.log(result.messageId);   // "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"console.log(result.status);      // "Sent"console.log(result.cost);        // 0.06

await client.send({  to: '393612345678',  from: 'YourName',  message: 'Привет 😀',  type: 'auto',   // diventa unicode automaticamente}); // Il rilevamento è esportato anche da solo:import { detectSmsType } from '@messageglobe/sdk'; detectSmsType('Hello world');  // 'plain'detectSmsType('Привет 😀');    // 'unicode'

const response = await client.send({  to: ['393612345678', '880172145789'],   // oppure "393612345678,880172145789"  from: 'YourName',  message: 'Hello everyone',}); for (const result of response.results) {  console.log(result.recipient, '=>', result.messageId);}

const result = await client.status('xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'); console.log(result.status);      // es. "Delivered"console.log(result.updatedAt);

{    "message_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",    "recipient": "393612345678",    "sender_id": "YourName",    "status_code": 1,    "status": "Delivered",    "updated_at": "2024-06-28T11:41:51.000000Z"}

import { ContactsClient } from '@messageglobe/sdk'; const client = new ContactsClient({ apiToken: 'XX|your-api-token' }); // Almeno uno tra phone ed email è obbligatorio.const contact = await client.create('list_uid_example', {  phone: '393310000000',  firstName: 'Jane',  lastName: 'Doe',}); console.log(contact.uid);       // "contact_uid_example"console.log(contact.status);    // "subscribe" // Elimina indicando la lista e l'uid del contatto.await client.delete('list_uid_example', 'contact_uid_example');

import { GroupsClient } from '@messageglobe/sdk'; const client = new GroupsClient({ apiToken: 'XX|your-api-token' }); const group = await client.create('Newsletter subscribers');const uid = group.uid; await client.show(uid);await client.update(uid, 'VIP subscribers');await client.delete(uid); // Elenca tutte le liste (dati grezzi, paginati)const page = await client.list();

import { SendersClient } from '@messageglobe/sdk'; const client = new SendersClient({ apiToken: 'XX|your-api-token' }); // Elenca tutti i sender IDfor (const sender of await client.list()) {  console.log(sender.senderId, '=>', sender.status); // "active" / "pending"} // Cerca un sender ID per nomeconst sender = await client.show('YourName'); // Creane uno nuovo: tutti i campi sono obbligatori, 3-11 caratteri.await client.create({  senderId: 'YourName',  company: 'Your Company',  taxCode: 'ABCDEF12G34H567I',  vatCode: '01234567890',  address: 'Via Roma 1',  city: 'Rome',  province: 'RM',  country: 'IT',  emailAddress: '[email protected]',  phone: '391234567890',  pecAddress: '[email protected]',}); // Elimina per nomeawait client.delete('YourName');

import { EmailClient } from '@messageglobe/sdk'; const client = new EmailClient({  host: 'smtp.messageglobe.com',  port: 587,  fromAddress: '[email protected]',  fromName: 'YourApp',  username: 'smtp-user',  password: 'smtp-password',  encryption: 'tls',}); await client.send({  to: { email: '[email protected]', name: 'Jane Doe' },  cc: '[email protected]',  replyTo: '[email protected]',  subject: 'Your report',  html: '<h1>Report ready</h1><p>See attachment.</p>',  text: 'Report ready. See attachment.',  attachments: [    { filename: 'report.pdf', path: '/path/to/report.pdf' },    { filename: 'data.csv', content: csvString, contentType: 'text/csv' },  ],}); // Rilascia il pool di connessioni allo spegnimento.await client.close();

import { EmailClient, messageGlobeSmtp } from '@messageglobe/sdk'; const client = new EmailClient(  messageGlobeSmtp({    username: '[email protected]',   // username di accesso a MessageGlobe    apiToken: 'XX|your-api-token',   // API token, usato come password SMTP    fromAddress: '[email protected]',    fromName: 'YourApp',  }),);

import { ApiError, MessageGlobeError, ValidationError } from '@messageglobe/sdk'; try {  await client.send(sms);} catch (error) {  if (error instanceof ValidationError) {    // Validazione lato client fallita  } else if (error instanceof ApiError) {    // L'API ha restituito un errore    console.log(error.message);         // "Invalid params"    console.log(error.apiErrorCode);    // 200    console.log(error.httpStatusCode);  // 422    console.log(error.errors);  } else if (error instanceof MessageGlobeError) {    // Qualsiasi altro errore dell'SDK  } else {    throw error;  }}

import { SmsClient, type HttpClient } from '@messageglobe/sdk'; const httpClient: HttpClient = {  async request({ method, url, headers, body, signal }) {    const response = await fetch(url, { method, headers, body, signal });     return {      statusCode: response.status,      body: await response.text(),      headers: Object.fromEntries(response.headers),    };  },}; const client = new SmsClient({ apiToken: 'XX|your-api-token', httpClient });