ChatMaxima Docs
క్యాంపెయిన్‌లుWhatsApp Flows

WhatsAppలో డైనమిక్ డేటా ఫ్లోను రూపొందించండి

ChatMaximaలో WhatsApp Dynamic Data Flowను రూపొందించండి, Category నుండి Product లేదా Doctor నుండి Date నుండి Time వంటి మీ APIనుండి లైవ్‌గా పూరించబడిన చైన్డ్ డిపెండెంట్ లిస్ట్‌లతో.

అవలోకనం

Dynamic Data Flow అనేది మీ స్వంత APIనుండి లైవ్‌గా దాని లిస్ట్‌లు పూరించబడే WhatsApp Flow. ప్రతి స్టెప్ ఒక లిస్ట్, మరియు ఒక స్టెప్‌లో కస్టమర్ ఎంపిక తదుపరి స్టెప్ ఏమి చూపిస్తుందో నిర్ణయిస్తుంది. ఈ ఫ్లో కస్టమర్‌ను డిపెండెంట్ ఎంపికల చైన్ ద్వారా నడిపిస్తుంది.

సాధారణ ఉదాహరణలు:

  • ఆరోగ్య సంరక్షణ - Doctor, తర్వాత అందుబాటులో ఉన్న Date, తర్వాత అందుబాటులో ఉన్న Time స్లాట్.
  • ఇ-కామర్స్ - Category, తర్వాత Product.
  • సేవలు - Branch, తర్వాత Service, తర్వాత Staff member.

Form Builder వలె కాకుండా, ఎంపికలు చేతితో నమోదు చేయబడవు. కస్టమర్ తదుపరి స్క్రీన్‌కు వెళ్లినప్పుడు, WhatsApp సురక్షితమైన ChatMaxima ఎండ్‌పాయింట్‌ను కాల్ చేస్తుంది, ఇది మీ APIని కాల్ చేసి తదుపరి లిస్ట్‌ను తిరిగి ఇస్తుంది. ఏదీ హార్డ్‌కోడ్ చేయబడదు, కాబట్టి మీరు నిర్వచించే ఏ స్టెప్‌ల చైన్‌కైనా అదే ఫ్లో పనిచేస్తుంది.

ఇది ఎలా పనిచేస్తుంది

  1. కస్టమర్ ఫ్లోను తెరిచి మొదటి స్టెప్‌యొక్క లిస్ట్‌ను చూస్తారు.
  2. వారు ఒక ఎంపిక చేస్తారు.
  3. WhatsApp ఆ ఎంపికను ChatMaximaయొక్క ఎన్‌క్రిప్టెడ్ ఎండ్‌పాయింట్‌కు పంపుతుంది.
  4. ChatMaxima మునుపటి ఎంపికలను పాస్ చేస్తూ తదుపరి స్టెప్ కోసం మీ APIని కాల్ చేస్తుంది.
  5. తదుపరి లిస్ట్ కనిపిస్తుంది. ఇది చివరి సారాంశ స్క్రీన్ వరకు పునరావృతమవుతుంది.

ముందస్తు అవసరాలు

మీరు ప్రారంభించడానికి ముందు, మీకు ఉన్నాయని నిర్ధారించుకోండి:

  • కనెక్ట్ చేయబడిన WhatsApp అకౌంట్ - ChatMaximaకు లింక్ చేయబడిన WhatsApp Cloud API నంబర్.
  • ప్రతి స్టెప్‌కు ఒక API - ఎంపికల JSON లిస్ట్‌ను తిరిగి ఇచ్చే HTTPS ఎండ్‌పాయింట్.
  • ఎన్‌క్రిప్షన్ కీ సెటప్ చేయబడింది - WhatsApp అకౌంట్‌కు ఒకసారి సెటప్, కింద వివరించబడింది.

గమనిక: Dynamic Data Flows ఎండ్‌పాయింట్-ఆధారితమైనవి, కాబట్టి WhatsAppకు ఎన్‌క్రిప్షన్ కీ అవసరం. మీరు డైనమిక్ ఫ్లోను సేవ్ చేయడానికి ముందు ఎన్‌క్రిప్షన్ సెటప్‌ను తప్పనిసరిగా పూర్తి చేయాలి.

స్టెప్ 1: డైనమిక్ డేటా ఫ్లోను ప్రారంభించండి

  1. Campaigns తర్వాత WhatsApp Flowsకు వెళ్లి Create Flowపై క్లిక్ చేయండి.
  2. Flow Name నమోదు చేసి Categoryను ఎంచుకోండి.
  3. Flow Typeను Dynamic Data Flowకు సెట్ చేయండి.

బిల్డర్ Dynamic Steps వ్యూకు మారుతుంది.

స్టెప్ 2: ఎన్‌క్రిప్షన్ కీని సెటప్ చేయండి

Dynamic Data Flow ప్రతి స్క్రీన్ కోసం ChatMaxima ఎండ్‌పాయింట్‌ను కాల్ చేస్తుంది, మరియు WhatsApp ఆ ఛానెల్ ఎన్‌క్రిప్ట్ అయి ఉండాలని కోరుతుంది.

  1. Endpoint Encryption కార్డ్‌లో, Set up Encryption Keyపై క్లిక్ చేయండి.
  2. ChatMaxima అకౌంట్ కోసం RSA కీ జతను రూపొందిస్తుంది మరియు పబ్లిక్ కీని ఆటోమేటిక్‌గా Metaకు అప్‌లోడ్ చేస్తుంది.

ఇది WhatsApp అకౌంట్‌కు ఒకసారి జరిగే చర్య. ఆ అకౌంట్‌లోని ప్రతి డైనమిక్ ఫ్లో అదే కీని పునర్వినియోగిస్తుంది.

స్టెప్ 3: స్టెప్‌లను జోడించండి

ప్రతి స్టెప్ ఒక డిపెండెంట్ లిస్ట్. Add Stepపై క్లిక్ చేసి స్టెప్ ఎడిటర్‌ను పూరించండి.

స్టెప్ ఫీల్డ్‌లు

ఫీల్డ్వివరణ
Step Titleస్క్రీన్ హెడ్డింగ్, ఉదాహరణకు Select a Category
Step Keyలోయర్‌కేస్ ఐడెంటిఫైయర్, ఉదాహరణకు category, తర్వాత {category}గా సూచించబడుతుంది
List Labelలిస్ట్ పైన చూపబడే లేబుల్
HTTP MethodAPI కాల్ కోసం GET లేదా POST
API URLఈ స్టెప్‌యొక్క ఎంపికలను తిరిగి ఇచ్చే ఎండ్‌పాయింట్
AuthenticationNone, Bearer Token, Basic Auth, లేదా Custom Header

మునుపటి ఎంపికలను పాస్ చేయడం

తదుపరి స్టెప్‌ను మునుపటి దానిపై ఆధారపడేలా చేయడానికి, మునుపటి స్టెప్ కీని దాని API URLలో ప్లేస్‌హోల్డర్‌గా ఉంచండి. ChatMaxima దాన్ని రన్‌టైమ్‌లో కస్టమర్ ఎంపికతో భర్తీ చేస్తుంది.

https://api.example.com/products?category={category}

ఈ ఉదాహరణలో, product స్టెప్‌యొక్క URL ఎంచుకున్న categoryను చొప్పిస్తుంది.

స్టెప్ 4: API ప్రతిస్పందనను మ్యాప్ చేయండి

స్టెప్ ఎడిటర్‌యొక్క Response Mapping విభాగం మీ APIయొక్క JSONను ఎలా చదవాలో ChatMaximaకు చెబుతుంది.

ఫీల్డ్వివరణ
List Pathప్రతిస్పందనలోని అర్రేకు పాత్, ఉదాహరణకు data. ప్రతిస్పందన ఇప్పటికే అర్రే అయితే ఖాళీగా వదిలేయండి
ID Fieldఎంపిక విలువగా ఉపయోగించబడే ఫీల్డ్, ఉదాహరణకు id
Title Fieldఎంపిక ప్రధాన టెక్స్ట్‌గా చూపబడే ఫీల్డ్, ఉదాహరణకు name
Description Fieldఐచ్ఛిక ద్వితీయ లైన్, ఉదాహరణకు price

price.amount వంటి నెస్టెడ్ ఫీల్డ్‌ల కోసం డాట్ నొటేషన్ మద్దతు ఇవ్వబడుతుంది.

స్టెప్ 5: సేవ్ చేసి పబ్లిష్ చేయండి

  1. Save Dynamic Flowపై క్లిక్ చేయండి. ChatMaxima మీ స్టెప్‌ల నుండి WhatsApp Flow స్క్రీన్‌లను రూపొందించి వాటిని అప్‌లోడ్ చేస్తుంది.
  2. సేవ్ చేసిన డ్రాఫ్ట్‌ను తెరిచి Publishపై క్లిక్ చేయండి.

చివరి స్క్రీన్ అనేది కస్టమర్ నిర్ధారించడానికి ముందు ప్రతి ఎంపికను రీక్యాప్ చేసే summary.

ఉత్తమ పద్ధతులు

  • స్పష్టమైన స్టెప్ కీలను ఉపయోగించండి - అవి URLలలో కనిపిస్తాయి కాబట్టి, చిన్నవి, లోయర్‌కేస్ మరియు అర్థవంతమైనవి.
  • చిన్న లిస్ట్‌లను తిరిగి ఇవ్వండి - WhatsApp లిస్ట్‌లు దృష్టి కేంద్రీకరించిన ఎంపికల సెట్‌తో ఉత్తమంగా పనిచేస్తాయి.
  • స్టెప్‌లను సాధారణ నుండి నిర్దిష్ట వరకు ఆర్డర్ చేయండి - ఉదాహరణకు Product కంటే ముందు Category.
  • ప్రతి APIని పరీక్షించండి - సేవ్ చేయడానికి ముందు ప్రతి ఎండ్‌పాయింట్ ఆశించిన JSONను తిరిగి ఇస్తుందని నిర్ధారించండి.

ట్రబుల్‌షూటింగ్

ఎన్‌క్రిప్షన్ కీ కోసం అడుగుతూ సేవ్ విఫలమవుతుంది

  1. Endpoint Encryption కార్డ్‌ను తెరవండి.
  2. Set up Encryption Keyపై క్లిక్ చేసి నిర్ధారణ కోసం వేచి ఉండండి.
  3. డైనమిక్ ఫ్లోను మళ్లీ సేవ్ చేయండి.

ఒక స్టెప్ ఖాళీ లిస్ట్‌ను చూపిస్తుంది

  1. API URL సరైనదని మరియు HTTPS ద్వారా చేరుకోగలదని తనిఖీ చేయండి.
  2. List Path, ID Field, మరియు Title Field మీ APIయొక్క JSONతో సరిపోతాయని ధృవీకరించండి.
  3. URLలో ఏదైనా {placeholder} మునుపటి స్టెప్ కీతో సరిపోతుందని నిర్ధారించండి.

ఒక స్టెప్ APIని చేరుకోలేకపోతుంది

  1. API పబ్లిక్ HTTPS ఎండ్‌పాయింట్‌గా ఉండాలి. అంతర్గత లేదా ప్రైవేట్ చిరునామాలు భద్రత కోసం బ్లాక్ చేయబడతాయి.
  2. ధృవీకరణ వివరాలు సరైనవని నిర్ధారించండి.

తదుపరి స్టెప్‌లు

ఈ పేజీలో