For the best experience turn off the battery saving mode.

Înapoi

Conector BSG pentru Creatio (fost BPM.Online)

Instalare

Instalarea se poate face fie de pe piața Creatio (BPM), fie din fișierul de arhivă, deoarece instalarea de pe piață ar putea fi finalizată cu un singur clic – nu este acoperită în acest manual.

Instalare manuală

Arhiva cu conector BSG poate fi descărcată din instalarea online Creatio (BPM)

Pentru a instala BSG Connector din arhivă, accesați secțiunea „Aplicație instalată” din „Proiectant sistem” și alegeți „Instalați din fișier” dintr-un meniu derulant:

Pe ecranul următor, selectați fișierul arhivat și încărcați-l:

Procesul de instalare va începe automat, dacă vor apărea erori – vă rugăm să păstrați jurnalul de instalare și să trimiteți la asistența noastră: support@bsg.world

Configurare

Trebuie să configurați conectorul BSG înainte de utilizare: specificați cheia API și numele implicit al expeditorului.

Pentru a accesa pagina de configurare pentru BSG Connector, accesați „System Designer”:

Apoi, în secțiunea „Import și integrare”, faceți clic pe linkul „Setări conector BSG”:

Dialogul modal cu setările conectorului BSG:

Dacă nu aveți cheia API pentru serviciul BSG – faceți clic pe linkul „Obțineți cheia BSG” și autentificați-vă în panoul BSG:

Apăsați butonul „Generați” și copiați cheia API primită:

live_1omLRXzXXXXXXXXXX – for production

or

test_1omLRXzXXXXXXXXXX – for testing

Introduceți cheia primită în câmpul de intrare „Cheie API”:

and press ‘Save’ button.

La succes, veți vedea fereastra de confirmare:

Există, de asemenea, linkul direct către pagina de configurare a conectorului chiar din formularul principal, dar numai dacă utilizatorul actual este administrator:

Dacă conectorul a fost configurat înainte – va exista un link pentru a-l deconecta de la BSG Service:

Utilizare

Conectorul nostru BSG este conceput pentru cazuri de utilizare comune și are caracteristici cheie:

  • single SMS delivery,
  • mass delivery,
  • message templates,
  • template tags
  • balance check
  • count SMS messages

Dacă afacerea dvs. necesită funcții mai specifice sau aveți nevoie de personalizare avansată – simțiți-vă o taxă pentru a contacta echipa noastră de asistență: support@bsg.world

Livrare unică SMS

Formularul principal pentru trimiterea SMS-ului se află în fila „BSG”, secțiunea de sus a paginii de contact selectate:

Forma principală în detalii:

Elemente de control:

  • Selected contact and the phone that SMS message will be send to
  • Dropdown with allowed tags
  • Message text
  • Validation messages
  • Symbol counter with split for actual SMS messages
  • Select pre-defined message template
  • Check balance in BSG Service (if connected)
  • Link/Unlink BSG Account from connector
  • Send SMS action button
  • Encode message into translit

La livrarea cu succes, veți vedea fereastra de notificare:

Livrare în masă SMS

Conectorul nostru BSG permite livrarea în masă a mesajelor SMS către mai multe contacte selectate (sau către toți). Pentru a face acest lucru, trebuie să accesați secțiunea „Contacte” și în meniul „Acțiuni” selectați „Selectați mai multe înregistrări” sau „Selectați toate”:

Apoi, după finalizarea selectării contactelor necesare, va trebui să selectați opțiunea „Trimiteți SMS (BSG)”:

Va exista un dialog modal cu detalii pentru livrarea în masă a SMS-urilor:

Elemente de control:

  • Number of selected contacts
  • SMS message text, supports tags input
  • Selection of pre-defined message template
  • Symbol counter with split for actual SMS messages
  • Action button to start mass delivery
  • Encode message to latin
  • Select tags for SMS message substitutions (see below)

Verificați soldul

Această opțiune va fi disponibilă numai după conectarea cu succes la contul BSG. Pentru a vedea soldul dvs. în BSG, faceți clic pe linkul „Sold” în forma conectorului principal:

Va exista o fereastră modală cu detalii despre sold:

Șabloane de mesaje SMS

Conectorul nostru permite crearea, utilizarea și gestionarea șabloanelor de mesaje SMS. Pentru a utiliza această caracteristică, faceți clic pe linkul „Șablon” din formularul conectorului principal (sau din formularul de livrare în masă):

Ecranul principal pentru șabloanele de mesaje SMS:

Elemente de control:

  • Select current template from list and back to delivery form
  • Add new template
  • Template search

La selectarea șablonului, sunt permise acțiuni comune în dicționar:

Și controlul implicit al vizualizării curente:

Opțiuni de filtrare pentru căutarea șablonului:

Pentru a crea noul șablon, apăsați butonul „Nou”, va exista o fereastră modală:

Elemente de control:

  • Action button to Save template
  • Template name
  • SMS message text

Mesajul SMS permite, de asemenea, introducerea etichetelor.

Etichete șablon

Conectorul nostru acceptă etichete în mesajele SMS. Pentru a le utiliza, trebuie să introduceți un cuvânt cheie special în textul mesajului și acesta va fi înlocuit automat la detalii de contact efective.

Mai jos este lista etichetelor acceptate:

Tag Description
#name# Full name of a contact
#GivenName# First name
#MiddleName# Middle name
#Surname# Surname
#JobTitle# Job Title
#BirthDate# Date of birth
#MobilePhone# Mobile phone
#Phone# Work phone
#HomePhone# Home phone
#Skype# Skype
#Email# Email
#Address# Address
#Zip# Zip

Toate etichetele nu disting majusculele și minusculele, deci toate vor funcționa: # nume #, # NAME #, # Name #

Înlocuiți numele expeditorului

Conectorul nostru permite să suprascrie numele expeditorului implicit pentru o valoare specificată în contul asociat.

Există un câmp specific „Numele expeditorului (BSG)” pe care conectorul nostru îl adaugă la instalarea în entitatea de cont, dacă acest câmp este completat – valoarea va fi utilizată pentru toate contactele asociate cu această entitate de cont.

Pentru a utiliza această caracteristică, accesați pagina Cont:

Și completați câmpul „Nume expeditor (BSG)”, apoi apăsați butonul „Salvați”.

Utilizare în procesul Creatio (fost BPM)

Conectorul nostru permite să utilizăm livrarea de servicii BSG ca pas în procesul Creatio. Mai jos este un exemplu pas cu pas despre cum să adăugați un astfel de pas într-un nou proces Creatio.

Accesați „Procesare bibliotecă”:

Apăsați butonul „Proces nou”:

Din lista din stânga (intitulată „Acțiuni utilizator”) selectați opțiunea „Trimiteți SMS” și trageți-o în diagrama BPM:

Linia de la începutul procesului ar trebui să fie conectată la pasul nostru, la fel ca linia de la pasul nostru până la punctul „sfârșitul procesului”.

Acum va trebui să completați parametrii pasului din (în dreapta):

Acești parametri sunt de obicei completați din pașii anteriori ai procesului Creatio, astfel încât etapa de livrare îi va lua din mediul procesului curent.

Pentru a verifica dacă am creat procesul corect, apăsați butonul „Executare”:

Folosind conectorul din scripturile Creatio BPM

Conectorul nostru permite să fie utilizat din așa-numita „Script Task” – pasul special în fluxul de proces Creatio cu script personalizat în interior.

Mai jos este un exemplu pas cu pas al modului de utilizare a acestuia pentru livrarea în masă a SMS-urilor.

  1. Navigați la secțiunea „Procesare bibliotecă” și creați un nou proces BPM, adăugați pașii „Citiți date” și „Script Task”, ca pe ecranul de mai jos:
  2. Faceți clic pe pasul „Citiți date” și configurați parametrii ca pe ecranul de mai jos:

    Connector așteaptă colectarea ID-urilor numai de la entitatea „Contact”, astfel încât toate celelalte câmpuri preluate nu vor fi utilizate.
  3. Faceți clic pe pasul „Task Script” și lipiți codul de mai jos:

    var log = global::Common.Logging.LogManager.GetLogger("BSGConnector");
    var userConnection = this.Get<UserConnection>("UserConnection");
    log.Info("test process has been started " );
    try {
    var colSource = Get<ICompositeObjectList<ICompositeObject>>("ReadDataUserTask1.ResultCompositeObjectList");
    var listIds = new List<Guid>();
    foreach (var parameter in colSource)
    {
    Guid value;
    parameter.TryGetValue("Id",out value);
    listIds.Add(value);
    log.Info(string.Format("parameter {0}",value));
    }
    log.Info(string.Format("total number of records: {0}",listIds.Count));
    var p = new Terrasoft.Configuration.BSGConnector.BSGUserTaskParameters();
    p.ContactIds = listIds;
    p.SmsMessage = "test message for mass delivery check, for #name# !";
    p.SenderName = "Santa-Claus";
    var smsTask = new Terrasoft.Configuration.BSGConnector.BSGUserTask(userConnection);
    smsTask.SendSms(p);
    } catch(Exception e) {
    log.Info("process error: " +e.Message);
    }
    return true;

Ar trebui să arate ca pe ecranul de mai jos:

Acest proces de testare va scrie înregistrări jurnal în fișierul jurnal implicit (Common.log), de asemenea, aceste înregistrări pot fi vizualizate în timp de execuție cu „Extensie de telemetrie” (vezi mai jos):

Depanare

Conectorul nostru acceptă mai multe niveluri de jurnalizare, astfel încât pentru a investiga sursa problemei, puteți ajusta nivelul jurnalului conectorului pentru a vedea mai multe detalii despre activitatea sa internă.

Numele jurnalului: BSGConnector

Un ghid detaliat despre cum se configurează înregistrarea jurnalului în instanța offsite Creatio Online poate fi găsit în documentația Creatio (anterior BPM Online).

Pentru instanțele cloud, puteți încerca această extensie „Jurnal de telemetrie pentru creatio”:

https://marketplace.creatio.com/app/telemetry-log-creatio

care va permite observarea jurnalelor conectorilor în timp real:

Pentru orice întrebări legate de conector, vă rugăm să contactați asistența noastră tehnică: support@bsg.world