Taqnyat

Taqnyat is a multi-channel provider. Wire each product into its sently channel sender — do not build a mega Taqnyat client.

SMS

Recipients are normalized to international digits (no + / leading 00).

Setup

import { createSmsSender } from "sently/sms";
import { TaqnyatSmsTransport } from "sently/transports/taqnyat-sms";

const taqnyat = new TaqnyatSmsTransport({
  bearerToken: process.env.TAQNYAT_TOKEN!,
  sender: "Taqnyat.sa",
});
const sms = createSmsSender({ transport: taqnyat });

Features

Pick a branch. Channel send goes through sms; everything else is called on taqnyat.

const result = await sms.send({
  to: "+9665xxxxxxxx",
  body: "Hello from sently",
});
console.log(result.messageId, result.response);

WhatsApp

Business-initiated chats must start with an approved template. Session text is only allowed after the user replies (24h window). Queued accepts may return statuses: "PENDING" with no message_id yet — still treated as accepted.

Setup

import { createWhatsAppSender } from "sently/whatsapp";
import { TaqnyatWhatsAppTransport } from "sently/transports/taqnyat-whatsapp";

const transport = new TaqnyatWhatsAppTransport({
  bearerToken: process.env.TAQNYAT_WHATSAPP_TOKEN!,
});
const wa = createWhatsAppSender({ transport });

Features

Pick a branch. Template/session send goes through wa; extras stay on transport.

await transport.optIn("+9665xxxxxxxx"); // once per recipient when required

const result = await wa.send({
  to: "+9665xxxxxxxx",
  template: {
    name: "demotest1_testr11",
    language: "ar",
    // components: [...] // when the template has variables
  },
});
console.log(result.messageId, result.response);

Email

from should be a sender address your Taqnyat account is allowed to use. See Sender Approval if email is not enabled in the portal yet.

Features

import { createMailer } from "sently/mailer";
import { TaqnyatMailTransport } from "sently/transports/taqnyat-mail";

const mailer = await createMailer({
  transport: new TaqnyatMailTransport({
    bearerToken: process.env.TAQNYAT_MAIL_TOKEN!,
    campaignName: "sently",
  }),
});

await mailer.send({
  from: "noreply@example.com",
  to: "person@example.com",
  subject: "Hello",
  text: "Hi",
  // html: "<p>Hi</p>",
});

Account verification & sender names

Portal onboarding from Taqnyat — required before a custom SMS sender is active. Not part of the sently API; complete these in the Taqnyat portal.

Account verification

1. Fill out the contract, sign it, and stamp it.
2. If the organization is subject to tax, attach the tax certificate.

New sender name

Troubleshooting

Contact & resources

Provider contact details from Taqnyat (account setup, packages, and platform guides).

API reference: SMS, WhatsApp, Verify, Mail.

Learn more

• Email channel — mailer options and send pipeline
• Sms channel — SMS sender options
• Whatsapp channel — template and session text
• Vendor OTP extras — OTP helpers on concrete transports

Next