پیامک و OTP کاوه‌نگار

1KAVENEGAR_API_KEY=<your-api-key-from-kavenegar-panel>2KAVENEGAR_VERIFY_TEMPLATE=<template-name-approved-in-kavenegar-panel>

1GET https://api.kavenegar.com/v1/{API_KEY}/verify/lookup.json

1{2  "return": {3    "status": 200,4    "message": "تایید شد"5  },6  "entries": [7    {8      "messageid": 123456789,9      "message": "your otp is 45123",10      "status": 5,11      "statustext": "ارسال به مخابرات",12      "sender": "10004346",13      "receptor": "09123456789",14      "date": 1715000000,15      "cost": 116    }17  ]18}

1// lib/kavenegar.ts23export interface SendOTPParams {4  receptor: string;5  token: string;6  template?: string; // overrides KAVENEGAR_VERIFY_TEMPLATE env var7  token2?: string;8  token3?: string;9  token10?: string;10  token20?: string;11  type?: "sms" | "call";12  tag?: string;13}1415export interface KavenegarResponse {16  return: {17    status: number;18    message: string;19  };20  entries?: Array<{21    messageid: number;22    message: string;23    status: number;24    statustext: string;25    sender: string;26    receptor: string;27    date: number;28    cost: number;29  }>;30}3132export async function sendOTPWithKavenegar(33  params: SendOTPParams34): Promise<KavenegarResponse> {35  const apiKey = process.env.KAVENEGAR_API_KEY;36  const defaultTemplate = process.env.KAVENEGAR_VERIFY_TEMPLATE;3738  if (!apiKey) throw new Error("KAVENEGAR_API_KEY is not set");39  if (!defaultTemplate) throw new Error("KAVENEGAR_VERIFY_TEMPLATE is not set");4041  const baseUrl = `https://api.kavenegar.com/v1/${apiKey}/verify/lookup.json`;42  const searchParams = new URLSearchParams({43    receptor: params.receptor.replace(/\s/g, ""),44    token: params.token,45    template: params.template ?? defaultTemplate,46  });4748  if (params.token2) searchParams.set("token2", params.token2);49  if (params.token3) searchParams.set("token3", params.token3);50  if (params.token10) searchParams.set("token10", params.token10);51  if (params.token20) searchParams.set("token20", params.token20);52  if (params.type) searchParams.set("type", params.type);53  if (params.tag) searchParams.set("tag", params.tag);5455  const response = await fetch(`${baseUrl}?${searchParams.toString()}`, {56    method: "GET",57  });5859  if (!response.ok) {60    throw new Error(61      `Kavenegar HTTP error: ${response.status} ${response.statusText}`62    );63  }6465  const data: KavenegarResponse = await response.json();6667  if (data.return?.status !== 200) {68    throw new Error(69      `Kavenegar rejected request: ${data.return?.message ?? "Unknown error"}`70    );71  }7273  return data;74}7576/** Normalises a phone number to the format Kavenegar expects. */77export function toKavenegarReceptor(phone: string): string {78  const cleaned = phone.replace(/\D/g, "");7980  // Iranian mobile: 989xxxxxxxxx → 09xxxxxxxxx81  if (cleaned.startsWith("98") && cleaned.length === 12) {82    return `0${cleaned.slice(2)}`;83  }8485  // Already local Iranian format86  if (cleaned.startsWith("09") && cleaned.length === 11) {87    return cleaned;88  }8990  // International: ensure 00 prefix91  if (cleaned.startsWith("00")) return cleaned;92  return `00${cleaned}`;93}

1import { sendOTPWithKavenegar, toKavenegarReceptor } from "@/lib/kavenegar";23const otp = "45123";4const phone = "989123456789";56await sendOTPWithKavenegar({7  receptor: toKavenegarReceptor(phone),8  token: otp,9  // template: "custom-template", // optional override10});