VOISDokümantasyon

VOIS for OpenCart

OpenCart mağazanızın siparişlerini VOIS'e bağlar: sipariş durumu değişince müşteriye SMS gider, yeni siparişte size haber gelir, sipariş sayfasından müşteriyi kendi dahilinizden tek tıkla ararsınız.

Eklentiyi indir (.ocmod.zip) Sürüm 1.0.0 · OpenCart 4.0.2 ve üzeri (4.1 dahil) · PHP 8.0+
Hızlı başlangıç

Mağazanızı 6 adımda bağlayın

Kod yazmanız gerekmez; OpenCart yönetim panelinden kurulur.

Başlamadan önce
  • OpenCart 4.0.2 ya da üzeri, yönetici erişimi
  • VOIS panel girişiniz (API anahtarı oluşturmak için)
  • VOIS SMS hesabı ve onaylı gönderen başlığı
  • Tıkla-ara için yöneticilerin VOIS dahilisi
  1. VOIS panelinde API anahtarı oluşturun. Ayarlar › Entegrasyonlar › REST API & Webhook sayfasında anahtara bir ad verin, SMS: gönder, SMS: rapor/okuma ve tıkla-ara için Ses: arama başlat/kapat yetkilerini işaretleyip oluşturun. Anahtar yalnız bir kez gösterilir; hemen kopyalayın.
  2. Eklentiyi yükleyin. vois.ocmod.zip dosyasını indirip Eklentiler › Yükleyici sayfasından yükleyin, VOIS satırında Kur'a basın.
  3. Modülü etkinleştirin. Eklentiler › Eklentiler'de türü Modüller seçin; VOIS satırında önce +, sonra kalem düğmesine basın.
  4. Anahtarı yapıştırın. Bağlantıyı sına'ya basın; hesap adınız, SMS bakiyeniz ve başlıklarınız görünür.
  5. SMS'leri seçin. Gönderen başlığını seçin, Durum SMS'leri sekmesinde SMS gidecek durumları işaretleyip Kaydet'e basın.
  6. Deneyin. Bir siparişi İşleniyor durumuna alın: müşteriye SMS gider ve siparişin geçmişine yazılır.

Ayrıntılı kurulum, cron ayarı ve sık karşılaşılan mesajlar aşağıda.

Neler yapar

Sipariş durumu SMS'i

Mağazanızdaki her sipariş durumu için (kendi eklediğiniz durumlar dahil) ayrı metin, ayrı aç/kapa.

Yeni sipariş bildirimi

Sipariş ilk kez işleme alındığında belirlediğiniz numaralara SMS.

Elle SMS

Sipariş sayfasındaki VOIS kutusundan müşteriye istediğiniz metni gönderin.

Tıkla-ara

"Ara" düğmesi önce sizin dahilinizi çaldırır, açınca müşteriyi arar. Görüşme santral kayıtlarınıza düşer.

SMS'ler sayfa yanıtı gönderildikten sonra gider, ödeme sayfası beklemez. Her gönderim ve hata, siparişin geçmişine (müşteriye bildirilmeden) yazılır.

Kurulum

  1. API anahtarı oluşturun. VOIS panelinde Ayarlar › Entegrasyonlar › REST API & Webhook sayfasında yeni anahtar oluşturun ve şu yetkileri işaretleyin: SMS: gönder, SMS: rapor/okuma, tıkla-ara için Ses: arama başlat/kapat. Anahtarı kopyalayın; bir daha gösterilmez.
  2. Eklentiyi yükleyin. OpenCart yönetim panelinde Eklentiler › Yükleyici (Extensions › Installer) sayfasında vois.ocmod.zip dosyasını yükleyin, listede çıkan VOIS satırında Kur'a basın.
  3. Modülü etkinleştirin. Eklentiler › Eklentiler sayfasında türü Modüller seçin, VOIS satırında yeşil + (Kur) düğmesine, ardından kalem (Düzenle) düğmesine basın.
  4. Bağlayın. Anahtarı yapıştırıp Bağlantıyı sına'ya basın. Hesap adınız, SMS bakiyeniz ve onaylı gönderen başlıklarınız görünür; eksik yetki varsa adıyla yazılır.
  5. Gönderen başlığını seçin, Durum SMS'leri sekmesinde SMS gidecek durumları işaretleyip metinleri düzenleyin; isterseniz Yeni sipariş sekmesine kendi numaralarınızı yazın. Sağ üstteki Kaydet'e basın.
  6. Tıkla-ara için Tıkla-ara sekmesinde her yönetici kullanıcının yanına VOIS dahili numarasını yazın (ya da herkes için varsayılan bir dahili girin).

Başlangıçta yalnız "Processing / İşleniyor" durumu açıktır. SMS yalnız Türkiye cep numaralarına gider; numara başka biçimdeyse sipariş geçmişinde belirtilir. Bir sipariş aynı durum için en fazla bir kez SMS alır; yalnız yorum eklemek SMS göndermez.

Arka planda gönderim ve cron

SMS'ler sipariş anında kuyruğa yazılır ve sayfanın yanıtı gönderildikten hemen sonra gider. LiteSpeed ve PHP-FPM kullanan sunucularda müşteri hiç beklemez; Apache mod_php'de istek, gönderim bitince (genelde 1 saniyeden kısa) kapanır. Ulaşılamayan gönderimler 3 kez denenir.

Takılan gönderimler için OpenCart'ın saatlik cron işi (Eklentiler › Cron, kod vois) kuyruğu boşaltır; bunun için sunucunuzda OpenCart cron'unun tanımlı olması gerekir. Ayar sayfasındaki Şimdi gönder düğmesi de bekleyenleri hemen gönderir.

Metinlerde kullanabileceğiniz alanlar

AlanÖrnek
{musteri_adi} / {musteri_soyadi}Ayşe / Yılmaz
{siparis_no}1042
{siparis_tutari}1.250,00 TL
{siparis_durumu}İşleniyor
{siparis_tarihi}13.11.2026
{odeme_yontemi}Kapıda ödeme
{magaza_adi}Mağazanızın adı
{kargo_takip}OpenCart'ta ayrı bir kargo takip alanı yoktur. Sipariş sayfasında durumu (ör. "Kargolandı") seçerken Müşteriyi bilgilendir açıksa yorum kutusuna yazdığınız metin buraya gelir, ör. Yurtiçi Kargo 123456. Bildirim kapalıysa iç notunuz SMS'e girmez.

Sık karşılaşılanlar

MesajNe yapmalı
Anahtarda eksik yetkiPanelde yetkileri işaretleyerek yeni anahtar oluşturun, eklentiye yapıştırın.
Bu VOIS hesabında SMS hizmeti tanımlı değilSMS hizmeti açtırmak için bize ulaşın.
Gönderen başlığı hatalı ya da onaylı değilBağlantıyı sınayın ve listedeki onaylı başlıklardan birini seçin.
SMS bakiyeniz yetersizBakiye yükleyin; sonraki siparişlerden itibaren SMS gider.
Dahiliye bağlı bir telefon yokMasa telefonunuzun ya da softphone'unuzun açık ve bağlı olduğunu kontrol edin.
Sipariş sayfasında VOIS kutusu yokModülün durumu açık mı, kullanıcınızın grubunda Siparişler için düzenleme izni var mı bakın. Kurulumdan sonra eklenen kullanıcı gruplarına Kullanıcılar › Kullanıcı Grupları'nda extension/vois/module/vois için erişim izni verin.

Ayrıntılı kayıt: system/storage/logs/vois.log (anahtar ve tam numara yazılmaz).

Kendi yazılımınız için

Eklentinin kullandığı uçlar herkese açıktır: SMS API (VOIS anahtarıyla) · Ses API. WooCommerce mağazalar için: VOIS for WooCommerce.