app2email API Ọnụahịa

Akwụkwọ

Submit-Info

Nkuzi Submit-Info: wuo fom site na ndepụta ajụjụ, bipụta ya na WhatsApp na ibe weebụ, rụọ ndabanye site na ọkwa n'igbe ozi a kekọrịtara nwere ọrụ, mee ka azịza na oku gaa na sistemụ gị akpaaka, ma hazie ihe niile site na API ma ọ bụ onye nnọchi AI.

Ị na-ede fom dị ka ndepụta ajụjụ dị mfe. app2email na-agbanwe ya ka ọ bụrụ fom n'ime WhatsApp na ibe weebụ nwere otu nzọụkwụ. Onye ahịa, ma ọ bụ otu n'ime ndị ọrụ ubi gị, na-ejuputa ya ma nata nkeji nchọta. Azịza na faịlụ ndị ahụ na-aghọ ndabanye n'igbe ozi a kekọrịtara, ebe ọ na-aga n'ọkwa gị ma na-akpali akpaaka gị.

Arịrịọ ego, ngwa ọrụ ma ọ bụ ngwa ọrụ ọhụrụ ọ bụla, nke ọ bụla dị ka otu ihe nwere ajụjụ dị iche na aha ọkwa dị iche. Ọ bụla n'ime ha dị dị ka template ị nwere ike iwube ma gbanwee.

Otu echiche

Fom, mgbe ahụ ndabanye, mgbe ahụ ọkwa, mgbe ahụ akpaaka, mgbe ahụ njikọ. Arịrịọ maka ọnụahịa, akwụkwọ ịnata, ọkọlọtọ mmefu, akụkọ nsogbu, ọrụ e mechara, akwụkwọ nnyefe, na akwụkwọ ego ndị a bụ otu ihe ahụ nwere ajụjụ dị iche na aha ọkwa dị iche.

Malite n'ime nkeji ise

  1. Meghee ya: na dashboard gị meghee ibe Submit-Info (/dashboard/app/submit, a na-emeghekwa ya site na Integrations). Tinye ya n'ọrụ.
  2. Mee fom: họrọ "New form" wee họrọ template, ma ọ bụ malite ya n'ihu. Nye ya aha ma dee ajụjụ gị. Ajụjụ ọ bụla bụ otu ahịrị: ederede ya, ụdị ya, na ma onye ahụ ga-ezaghachi ya.
  3. Bipụta: "Publish to WhatsApp" na-ebuga fom ahụ na WhatsApp ma mee ka ọ dị ndụ. Ibe weebụ nwere otu nzọụkwụ ahụ dị ndụ ozugbo.
  4. Kekọrịta: n'okpuru Share ị na-enweta okwu nke na-emeghe fom n'ime mkparịta ụka gị, njikọ na-emeghe mkparịta ụka gị na okwu ahụ edepụtara, adreesị ibe weebụ ahụ, koodu QR, na ihe a na-etinye n'ime weebụsaịtị gị iji tinye fom ahụ.
  5. Rụọ igbe ozi: ndabanye ọhụrụ na-abata na Inbox. Meghee otu, gbanwee ọkwa ya, zaghachi. Kpọọ ndị otu gị mgbe ị dị njikere.

Ọ dịghị ihe na-agbanwe maka nọmba na-enweghị mmeghe Submit-Info. Fom nke a na-ebipụtaghị na WhatsApp ka na-arụ ọrụ: okwu ya na-azaghachi site na njikọ ibe weebụ ahụ.

Ihe owuwu fom

Fom nwere nzọụkwụ 1 ruo 12, nzọụkwụ ọ bụla nwere aha na ajụjụ 1 ruo 12. Enweghị canvas na enweghị ihe ị ga-adọrọ: otu ndepụta ahụ na-achịkwa fom n'WhatsApp, ibe weebụ, nlele azịza, ahịrị nke mbipụta tebụl, mbupụ na API. Ihe nlele n'akụkụ ihe ndezi na-egosi fom dịka mmadụ si ahụ ya.

ỤdịIhe onye ahụ na-enyeIhe ị nwere ike ịtọ
textAzịza mkpụmkpụogologo kasị nta na kasị ukwuu, ụkpụrụ ederede
textareaAzịza ogologo karịogologo kasị nta na kasị ukwuu
numberNọmbaụkpụrụ kasị nta na kasị ukwuu, ọkwa decimal, otu dịka kWh
emailAdreesị email
phoneNọmba ekwentị
dateỤbọchịole ụbọchị azụ ma ọ bụ n'ihu ka ọ nwere ike ịbụ
selectOtu nhọrọnhọrọ (2 ruo 200), ma ọ bụ ndepụta nke gị
multiselectỌtụtụ nhọrọnhọrọ (2 ruo 20), kasị nta na kasị ukwuu a ga-apịa
yesnoEe ma ọ bụ Mba
ratingAkara site na 1 ruo 3-10akara kasị elu
consentOkwu a ga-ekwenyema a ga-apịa ya ka ọ dị mkpa
photoFoto otu ma ọ bụ karịaole ọ bụla (1 ruo 10); igwe ọkụ, galeri ma ọ bụ nke ọ bụla
documentFaịlụ otu ma ọ bụ karịaole ọ bụla (1 ruo 10); faịlụ ọ bụla, PDF, foto ma ọ bụ faịlụ ọfịs
locationEbe onye ahụ nọna WhatsApp, arịrịọ ọnọdụ; na ibe weebụ, bọtịnụ na ahịrị adreesị
infoEderede ị na-egosia naghị ajụ ma ọ naghị echekwa ihe ọ bụla
hiddenUru na-abịa na njikọdịka nọmba ọrụ; a naghị egosi ihe ọ bụla
  • Ederede enyemaka na uru ndabara: ajụjụ ọ bụla nwere ike ibu ntụziaka mkpụmkpụ, na uru ndabara. Uru ndabara nwere ike iji ihe ị maara eme ihe, dịka {contact.name}.
  • Gosi naanị mgbe: nzọụkwụ ma ọ bụ ajụjụ nwere ike ịdabere na azịza gara aga ("gosi nzọụkwụ a naanị mgbe Problem bụ Yes"). WhatsApp na ibe weebụ na-esoro otu iwu ahụ.
  • Ubi nke ime: ubi a na-ajụbeghị ajụjụ. Ndị otu gị ma ọ bụ akpaaka na-ejuputa ha: uru ego nke quote, ihe kpebiri, ID nke sistemu ọzọ nyefere. Ha na-egosi naanị na igbe ozi na mbupụ.
  • Ndepụta: ajụjụ nhọrọ nwere ike iwere nhọrọ ya n'ndepụta nke gị (saịtị, ọrụ, ngwaahịa na ọnụahịa). Gbanwee ndepụta na dashboard ma ọ bụ site na API, fom ga-esochi, na-enweghị ichọ ibipụta ọzọ.
  • Uru a gbakọtara: usoro n'elu azịza, maka nlele ngwa ngwa ma ọ bụ nlele. Lee usoro.
  • Mgbe izipu: nlele tupu izipu, azịza nwere nkeji nchọta, mkpebi "Add more" nke na-ejikọ ozi ọzọ (ederede, foto, faịlụ) na ndabanye ahụ maka nkeji iri, na njikọ ibe ọkwa nke onye ahụ.
  • Ibipụta: app2email na-ede fom WhatsApp maka gị, na-ekewa nzọụkwụ ogologo n'ọtụtụ ihuenyo mgbe oke WhatsApp chọrọ ya, ma na-echekwa ụdị ntanetị ise ikpeazụ ka oziochie ka na-emeghe fom ahụ ọ zigara ya.

Ibe weebụ. Otu nzọụkwụ ahụ na /form/your-code/form-key. Ọ na-arịọ aha na nọmba WhatsApp n'ikpeazụ. Mgbe izipu, onye ahụ na-ahụ nkeji nchọta wee nwee ike ịpị "Get updates on WhatsApp", nke na-ekwenye nọmba ya site na otu ozi; a ga-ahọrọ fom ka ọ chọọ nke a. Njikọ onwe (nke ị zipụrụ) already maara onye ahụ ọ bụ. Iji tinye fom ahụ n'weebụsaịtị gị, jiri ihe a na-etinye n'okpuru Share; ọ bụrụ na fom na-arịọ ọnọdụ, tinye allow="geolocation" na iframe. A na-eme foto ka ha dị obere n'ụzụ ntanetị tupu a bulite ha; faịlụ nwere ike ịbụ ruo 10 MB.

Otu ndị mmadụ si aga n'ime fom

  • Okwu: fom ọ bụla nwere okwu nke ya. Okwu ndị a: form, forms, report na submit (ị nwere ike ịgbanwe ha) na-edepụta fom gị dịka menu mgbe e nwere ọtụtụ. Okwu a na-agụta naanị n'ozi mkpụmkpụ: nke nwere ihe fọdụrụ karịa 10 (Settings, "Ignore the words in long messages"), n'ihi ya ozi ogologo nke nwere ya agaghị amalite ihe ọ bụla.
  • Njikọ ma ọ bụ koodu QR: njikọ na-emeghe mkparịta ụka WhatsApp gị na okwu fom ahụ, ma ọ bụ adreesị ibe weebụ ahụ.
  • Ị zipụrụ ya: "Send form" na igbe ozi, ma ọ bụ API, na-zipu fom gaa na otu nọmba, na uru edejuputara (nọmba ọrụ, akaụntụ, akwụkwọ ị chọrọ).
  • Ịgbaso: akpaaka ma ọ bụ otu n'ime ndị otu na-arịọ fom nke abụọ maka ihe ọzọ. Ihe a na-azaghachi ka a na-ejikọta ya na ndabanye mbụ.
  • Ibe weebụ, na API maka sistemụ ndị nwere data ahụ.

Onye nwere ike izipu. Onye ọ bụla (nhọrọ a na-ahọrọ nke ukwuu), ma ọ bụ naanị nọmba ndị ị depụtara ma ọ bụ kọntaktị nwere tag nke gị. Nke a bụ otu fom ji nọgide na ndị ọrụ ubi gị. Okwu status na-azaghachi onye ahụ site na ọkwa ndabanye ya nke ọ bụla nke na-adịbeghị anya.

Ọkwa

Ọkwa bụ nke fom. Fom ọhụrụ na-amalite na New, In progress na Done; gbanwee aha ha, tinye nke gị (2 ruo 12), ma họrọ agba. Ọkwa ọ bụla bụ otu n'ime ụdị atọ: open, done ma ọ bụ cancelled.

  • Onye nwere ike ịhọrọ ya: debe ọkwa maka ụfọdụ ọrụ. Onye Agent na-akwadebe, naanị Manager na-anabata.
  • Ihe ndetu chọrọ: jụọ ihe kpatara mgbe a na-ebufe ndabanye n'ebe ahụ (jụrụ, jụ, ajụjụ).
  • Ozi: ederede a na-ezipu onye ahụ mgbe ndabanye ya ruru ọkwa ahụ, nwere ihe ntinye.
  • Bọtịnụ maka onye ahụ: azịza nwere ike ibu bọtịnụ ruo atọ (Accept, Decline, "Not fixed yet"), na ọ bụla n'ime ha na-agbanwe ọkwa. Naanị nke a na-enye gị nkwenye ọnụahịa, ikwenye nleta, na "ọ dị mma?".

Azịza a dere n'èzí oge azịza WhatsApp na-echekwa ma na-enyefe mgbe onye ahụ dere ọzọ. Igbe ozi na-ekwu otu ihe ahụ na azịza ahụ.

Igbe ozi na ọrụ

Inbox na-egosi Open, Mine, Unassigned, Done na All, yana echiche ị chekwara. Chọọ ma sịfụta site na fom, ọkwa, onye e kenyere, tag, ụzọ na ụbọchị. Ụdị atọ: ndepụta, tebụl (otu fom: ajụjụ ọ bụla bụ kolụm) na board (otu fom: kolụm maka ọkwa ọ bụla). Mkpọrọ ọtụtụ ahịrị iji gbanwee ọkwa, kenye, tag, bupụta ma ọ bụ hichapụ ha n'otu oge.

Ndabanye ọ bụla na-egosi azịza ya, faịlụ ya, ebe a si ziga ya, na otu akụkọ nke ihe niile mere ya: mgbanwe ọkwa na onye na ihe kpatara ya, ndetu, azịza n'akụkụ abụọ, faịlụ, na nzọụkwụ akpaaka ọ bụla na nsonaazụ ya. N'ala, ị na-ede ma ndetu dị n'ime ma ọ bụ azịza WhatsApp. Bupụta echiche ọ bụla dị ka CSV, Excel ma ọ bụ JSON, na otu ndabanye dị ka PDF.

Ndị otu gị. Kpọọ ndị mmadụ site na email ka ha nwee naanị igbe ozi. Ha na-enweta app dị mfe nke nwere onwe ya n'ebe /desk ma ọ hụghị akaụntụ gị ndị ọzọ. Ọrụ bụ otu ọdịnala nke ikike, ma e nwere ike ịgbanwe ikike ọ bụla maka otu onye.

ỌrụNa-amalite na
Onye nwe, AdminIhe niile, gụnyere fom, akpaaka, njikọ na ndị otu
ManagerNdetu, azịza, ndezi azịza, mgbanwe ọkwa, ikenye, faịlụ, bupụta, hichapụ, ịgba akpaaka n'aka
AgentNdetu, azịza, ndezi azịza, mgbanwe ọkwa, faịlụ, ịgba akpaaka n'aka. Nwere ike iwere ndabanye maka onwe ya
ViewerNwere ike ịgụ, naanị nke ahụ

Ị nwere ikwu ihe onye ọ bụla hụrụ: naanị fom ụfọdụ, naanị ihe e kenyere ya (na ma ọ bụ na-enweghị ndị e kenyeghị ka ha nwee ike ịnara), na nzọụkwụ kọntaktị zoro. Onye otu ọ bụla na-ekwu ihe ọ bụla na akụkọ ndabanye.

Ibe nke onye ahụ. Ndabanye ọ bụla nwere ibe nzuzo na /s/a-long-code, enweghị ịbanye: ọkwa, ozi na mgbanwe ọkwa ruo ugbu a, ajụjụ gị meghere nwere bọtịnụ ya, na "Add information" mgbe fom kwere ka ọ dị. Ndetu dị n'ime na ubi dị n'ime adịghị mgbe na-anọ n'ibe a.

Nzuzo. Ihichapụ kọntaktị na-ehichapụ ndabanye na faịlụ ya. Fom nwere ike nwee oge echekwa, mgbe ahụ a na-ehichapụ ndabanye emechiri.

Akpaaka

Akpaaka ọ bụla na-agụ dị ka ahịrịokwu: mgbe ihe ụfọdụ mere, ọ bụrụ ihe ụfọdụ bụ eziokwu, mee ihe ndị a n'usoro. "Mgbe a na-ezipu Quote request, ọ bụrụ na quantity bụ 20 ma ọ bụ karịa, kenye ya Managers wee zipu email gaa onye nwe."

MgbeNa-agba ọsọ mgbe
submittedndabanye zuru ezu ma faịlụ ya abataala
status_changedọkwa gbanwere (nhọrọ: gaa na ma ọ bụ site n'ọkwa ụfọdụ)
assignedonye a kenyere ya gbanwere
updatedazịza ma ọ bụ ubi dị n'ime dezigharịrị
note_addedotu n'ime ndị otu dere ndetu
file_addede tinyere faịlụ mgbe e mesịrị
customer_repliedonye zigara ya tinyere ederede ma ọ bụ faịlụ
buttononye ahụ pịarịrị otu bọtịnụ nke azịza ị nyere
overdueọ ka nọ n'otu ọkwa mgbe oge nke ọnụọgụgụ nkeji gasịrị
dueoge ya ruru mgbe ọ na-emeghe
manualotu n'ime ndị otu pịrị bọtịnụ omume ahụ na ndabanye ahụ

Ọ bụrụ: iwu maka azịza, uru a gbakọtara, ọkwa, ụzọ, tag na onye a kenyere ya. Iwu bụ ubi, onye ọrụ na uru: equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte. Jikọọ iwu site na all (na) ma ọ bụ any (ma ọ bụ).

MeeIhe ọ na-eme
set_statusbufere ya gaa n'ọkwa, na ndetu
assigngaa n'otu onye, n'usoro site n'ọrụ, gaa n'onye na-enwe obere ọrụ nke ọrụ, ma ọ bụ gaa n'onye ọ bụla
set_field, calculatedee ubi dị n'ime, ma ọ bụ gbakọta ya site na usoro
tag, set_priority, set_duetags, mkpa, oge ịga
replyozi WhatsApp gaa onye ahụ, nwere bọtịnụ ruo 3 nke ọ bụla na-agbanwe ọkwa, faịlụ, ma ọ bụ njikọ ibe ọkwa ya
ask_locationjụọ onye ahụ ka ọ kekọrịta ebe ọ nọ
send_formzipu fom nke ọzọ; ihe na-alaghachi na-esonyere ndabanye a
emailgaa onye nwe, onye e kenyere ya, onye ahụ, ma ọ bụ adreesị ọ bụla, faịlụ na-esonyere
notifyemail gaa onye e kenyere ya, ọrụ, ma ọ bụ ndị otu niile
http, openapi, mcpkpọọ njikọ ma debe akụkụ azịza n'ubi
waitgaa n'ihu mgbe e mesịrị, naanị ọ bụrụ na ọnọdụ ka dị
stopkwụsị ebe a

A na-edekọ onye ọ bụla n'usoro: ihe ezipụrụ, ihe laghachiri, ogologo oge ọ were. "Try with a submission" na-agba akpaaka n'ime ndabanye n'ezie na-enweghị ịgbanwe ma ọ bụ izipu ihe ọ bụla. Oku gaa sistemụ a na-adịghị mma na-anwale ọzọ mgbe nkeji 1, nkeji 10 na awa 1; mgbe ahụ akpaaka ahụ bụ ihe na-adaghị ma webhook gị natakwa submit.automation_failed. Akpaaka ndị na-akpali onwe ha na-akwụsị mgbe ọkwa atọ.

Usoro 1: arịrịọ ọnụahịa buru ibu gaa n'ọchịagha

{
  "name": "Large quotes go to a manager",
  "form": "quote_request",
  "enabled": true,
  "trigger": "submitted",
  "options": {},
  "conditions": {
    "all": [
      {
        "field": "quantity",
        "gte": 20
      }
    ]
  },
  "actions": [
    {
      "type": "assign",
      "to": "role:manager"
    },
    {
      "type": "set_priority",
      "priority": "high"
    },
    {
      "type": "email",
      "to": [
        "owner"
      ],
      "subject": "Large quote {reference}",
      "body": "{contact.name} asked for a quote.\n\n{answers}\n\n{desk_link}",
      "attach_files": true
    }
  ]
}

Usoro 2: zipu ọnụahịa, rịọ azịza, cheta mgbe ụbọchị atọ gachara

quote_amount bụ ubi dị n'ime ndị otu gị na-ejuputa tupu ha ebufee ndabanye ahụ gaa Quoted. Ndetu ahụ na-apụta naanị ma ọ bụrụ na ndabanye ka nọ na Quoted.

{
  "name": "Send the quote and ask for an answer",
  "form": "quote_request",
  "enabled": true,
  "trigger": "status_changed",
  "options": {
    "to": [
      "quoted"
    ],
    "from": []
  },
  "conditions": {
    "field": "status",
    "equals": "quoted"
  },
  "actions": [
    {
      "type": "reply",
      "text": "Your quote {reference}: {quote_amount}. Would you like to go ahead?",
      "link": true,
      "buttons": [
        {
          "id": "accept",
          "title": "Accept",
          "set_status": "accepted"
        },
        {
          "id": "decline",
          "title": "Decline",
          "set_status": "declined"
        }
      ]
    },
    {
      "type": "wait",
      "minutes": 4320
    },
    {
      "type": "reply",
      "text": "A reminder about your quote {reference}. Tap Accept or Decline, or write to us with any question."
    }
  ]
}

Usoro 3: debe nkọwa mita nke yiri ihe na-adịghị mma

usage bụ uru a gbakọtara: reading - previous('reading').

{
  "name": "Query a reading that looks wrong",
  "form": "meter_reading",
  "enabled": true,
  "trigger": "submitted",
  "options": {},
  "conditions": {
    "any": [
      {
        "field": "usage",
        "lt": 0
      },
      {
        "field": "usage",
        "gt": 2000
      }
    ]
  },
  "actions": [
    {
      "type": "set_status",
      "status": "queried",
      "note": "Usage {usage} kWh is outside the usual range."
    },
    {
      "type": "notify",
      "to": "role:manager",
      "text": "Reading {reference} for meter {meter_no} needs a check: usage {usage} kWh."
    }
  ]
}

Njikọ

Njikọ bụ sistemu a na-èwe ịga nke akpaaka nwere ike ịkpọ. Webhook nke akaụntụ gị achọghị ya: ha na-anata ihe omume ndabanye ọ bụla ka ọ na-eme (lee ihe omume). Maka ihe ndị ọzọ, enwere ụdị atọ. "Test" na njikọ, na "Try with a submission" na omume, na-egosi arịrịọ n'ezie na azịza n'ezie tupu a tinye ihe ọ bụla.

Arịrịọ HTTP

Adreesị isi na ụzọ ịbanye (enweghị, bearer token, akara, aha onye ọrụ na paswọọdụ, ma ọ bụ igodo n'adreesị). Omume ahụ na-akọ usoro (method), ụzọ (path), na ahụ JSON. save na-echekwa akụkụ azịza n'ubi nke ndabanye.

{
  "key": "billing",
  "name": "Billing",
  "kind": "http",
  "base_url": "https://billing.example.com/api",
  "auth": {
    "type": "bearer",
    "secret": "YOUR_BILLING_TOKEN"
  },
  "enabled": true
}
{
  "type": "http",
  "connection": "billing",
  "method": "POST",
  "path": "/readings",
  "body": {
    "meter": "{meter_no}",
    "reading": "{reading}",
    "usage": "{usage}",
    "reference": "{reference}",
    "photo": "{files.photo}"
  },
  "save": {
    "billing_id": "$.id"
  },
  "on_fail": "retry"
}

Akwụkwọ OpenAPI

Nye adreesị nke akwụkwọ OpenAPI 3 n'ụdị JSON, ma ọ bụ tinye ya. app2email na-agụ ọrụ ya; omume ahụ na-ahọrọ otu site na id ya wee tinye parameters ya. A naghị agụ akwụkwọ YAML na Swagger 2.

{
  "key": "helpdesk",
  "name": "Helpdesk",
  "kind": "openapi",
  "base_url": "https://helpdesk.example.com/api",
  "spec_url": "https://helpdesk.example.com/openapi.json",
  "auth": {
    "type": "header",
    "name": "X-Api-Token",
    "secret": "YOUR_HELPDESK_TOKEN"
  },
  "enabled": true
}
{
  "type": "openapi",
  "connection": "helpdesk",
  "operation": "createTicket",
  "params": {
    "title": "Problem {reference}: {category}",
    "description": "{description}",
    "reporter": "{contact.phone}"
  },
  "save": {
    "ticket_id": "$.id"
  },
  "on_fail": "retry"
}

MCP server

Nye adreesị nke MCP server (streamable HTTP) na token ya. app2email na-edepụta ngwa ọrụ server ahụ; omume ahụ na-ahọrọ otu n'ime ha wee tinye arguments ya. $text na-echekwa azịza zuru ezu nke ngwa ọrụ ahụ dịka ederede.

{
  "key": "dispatch",
  "name": "Dispatch",
  "kind": "mcp",
  "base_url": "https://dispatch.example.com/mcp",
  "auth": {
    "type": "bearer",
    "secret": "YOUR_DISPATCH_TOKEN"
  },
  "enabled": true
}
{
  "type": "mcp",
  "connection": "dispatch",
  "tool": "close_job",
  "arguments": {
    "job_id": "{job}",
    "summary": "{work_done}",
    "minutes": "{time_spent}",
    "photos": "{files.photos}"
  },
  "save": {
    "dispatch_answer": "$text"
  },
  "on_fail": "continue"
}

Ihe ị kwesịrị ịma. Uru nke nwere naanị otu placeholder na-echekwa ụdị ya (nọmba na-anọgide nọmba, ndepụta na-anọgide ndepụta). A na-echekwa nzuzo n'ụzọ nzuzo, a naghị egosi ya ọzọ ma API anaghị eweta ya. Adreesị ga-abụ https na nke ọha: adreesị nke ime, nke mpaghara na nke ndị ọzọ a na-ajụ, a naghịkwa agbasọ mgbanaka. Oku nwere ike were sekọnd 15 ma azịza nwere ike ịbụ 256 KB. Na save, ụzọ bụ $ (azịza niile) ma ọ bụ ụzọ dị mfe dịka $.data.items[0].id.

Placeholders

Ederede ọ bụla na parameter ọ bụla nke omume nwere ike iji placeholders n'akpụkpọ ọnụ ọkwa. Aha a na-amaghị ka ọ na-anọgide dịka ị dere ya.

PlaceholderỌ na-aghọ
{<field key>}azịza nke ajụjụ ahụ (ubi dị n'ime, uru a gbakọtara na uru akpaaka chekwara)
{reference}nkeji nchọta, dịka MR-7Q3M2A
{form} {form_key}aha fom na key ya
{status} {status_name}key ọkwa na aha ya
{channel}whatsapp, web, api ma ọ bụ staff
{priority} {tags}mkpa na tags
{created} {updated} {due}oge
{contact.name} {contact.phone} {contact.email}onye zigara ya
{assignee.name} {assignee.email}onye otu e kenyere ya
{link}ibe nke onye ahụ nwere onwe ya
{desk_link}ndabanye n'igbe ozi ndị otu gị
{answers}azịza niile dịka ahịrị "Label: value"
{files} {files.<field key>}njikọ nke faịlụ niile, ma ọ bụ nke faịlụ otu ajụjụ; sistemụ ọzọ nwere ike ịchọta ha ruo ụbọchị 7
{note}ndetu mgbanwe ọkwa, ma ọ bụ ndetu nke kpalitere akpaaka ahụ
{button}bọtịnụ onye ahụ pịrị
{business}aha azụmahịa gị
{submission}n'ahụ JSON: ndabanye niile dịka object
{= formula }usoro a na-agbakọta n'ebe ahụ, dịka {= round(qty * 1.1, 2) }

Usoro

A na-eji ya maka uru a gbakọtara, maka omume calculate, na n'ime {= ... } n'ederede ọ bụla. Usoro na-arụ ọrụ na nọmba, ederede n'etiti single quotes na key nke ajụjụ gị. Ọ nwere ike ịdị ogologo mkpụrụedemede 500. Ikewa site na efu, ma ọ bụ nọmba na-efu, na-enye uru efu kama njehie.

Ihe ị dereIhe ọ pụtara
+ - * / %mgbakọ na nọmba na azịza
== != > >= < <=ntụnyere
and or not ( )mgbagha na mgbanaka
if(condition, a, b)a mgbe ọnọdụ ahụ bụ eziokwu, ma ọ bụghị b
min(a, b, ...) max(a, b, ...)nke kacha nta, nke kacha ukwuu
round(x, n) abs(x)mgbakọ na n decimal, ibu nke nọmba na-enweghị akara
num(x) len(x)ederede dịka nọmba; ogologo nke ederede ma ọ bụ ndepụta
coalesce(a, b)a, ma ọ bụ b mgbe a efu
lower(x) upper(x) concat(a, b, ...)ederede
lookup('list', id, 'column')kolụm nke otu ahịrị nke otu ndepụta gị, dịka ọnụahịa
previous('field')azịza ikpeazụ onye ahụ nyere maka ajụjụ ahụ
count_files('field')ole faịlụ ajụjụ ahụ nwere
days_since(date)ụbọchị site na ụbọchị ruo taa

Ihe atụ: qty * lookup('prices', product, 'price') maka nlele ngwa ngwa; reading - previous('reading') maka ojiji; if(amount > 500, 'manager', 'agent') iji kpebie onye ga-anabata.

Maka ndị mmepe na ndị onye nnọchi AI

Ihe niile dị n'elu dị na REST API n'okpuru /v1/{number}/submit, ebe {number} bụ nọmba WhatsApp gị nwere koodu mba, naanị ọnụọgụgụ. Zipu igodo API gị dịka Authorization: Bearer YOUR_API_KEY (a na-anabatakwa isi X-API-KEY). Igodo chọrọ ikike submissions:manage; igodo nwere ohere zuru ezu nwere ya, igodo Default enweghị ya. Igodo sandbox enweghị ike ide ihe.

  1. GET /submit/guide: akwụkwọ JSON otu ihe nke okwu niile: ụdị ajụjụ na nhọrọ ha na oke, iwu ọkwa, ihe kpalitere, ọrụ, parameters ha, placeholders, ọrụ usoro, template, na ihe atụ ndị e mere.
  2. POST /submit/setup na "dry_run": true: a naghị ede ihe ọ bụla; nsogbu niile na-alaghachi na path ya na otu ahịrịokwu na-akọwa otu esi edozi ya.
  3. POST /submit/setup na-enweghị dry_run: ndepụta, njikọ, fom na akpaaka na-etinye ọnụ. Ọ bụrụ na nsogbu ọ bụla dị, a naghị ede ihe ọ bụla.
  4. POST /submit/forms/{key}/publish, ma ọ bụ kpọọ fom ndị ahụ n'ime "publish" nke akwụkwọ nhazi.
  5. Kekọrịta njikọ fom (GET /submit/forms/{key} na-alaghachi ha), mgbe ahụ gụọ GET /submit/submissions ma ọ bụ gee ntị n'ihe omume webhook.

Oku nhazi zuru ezu

Chekwaa akwụkwọ dị n'okpuru dịka setup.json wee zipu ya. Dochie 61400000000 ka nọmba gị. Ọ na-enyocha ngwọta ọkọlọtọ ọnụọgụgụ ọkwa ọrụ: ndepụta saịtị, njikọ gaa sistemu ịpụta ego, otu fom nwere ọkwa atọ na usage agbakọtara, na akpaaka abụọ. Wepụ "dry_run": true iji tinye ya. Fom, ndepụta na njikọ ndị nwere otu key ga-edochi ndị ochie; akpaaka a na-atụnyere site na aha n'ime fom. "preset": "..." n'ọnọdụ akụkụ ahụ na-etinye otu n'ime template (GET /submit/presets na-edepụta ha).

curl -X POST "https://api.app2email.com/v1/61400000000/submit/setup" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @setup.json
{
  "dry_run": true,
  "settings": {
    "enabled": true,
    "config": {
      "business_name": "Northside Energy",
      "default_prefix": "NE"
    }
  },
  "lists": [
    {
      "key": "sites",
      "name": "Sites",
      "items": [
        {
          "id": "north",
          "title": "North depot"
        },
        {
          "id": "south",
          "title": "South depot"
        }
      ]
    }
  ],
  "connections": [
    {
      "key": "billing",
      "name": "Billing",
      "kind": "http",
      "base_url": "https://billing.example.com/api",
      "auth": {
        "type": "bearer",
        "secret": "YOUR_BILLING_TOKEN"
      },
      "enabled": true
    }
  ],
  "forms": [
    {
      "key": "meter_reading",
      "name": "Meter reading",
      "definition": {
        "title": "Meter reading",
        "description": "Send us your reading. It takes about a minute.",
        "prefix": "MR",
        "steps": [
          {
            "key": "reading",
            "title": "Your reading",
            "text": "",
            "show_if": null,
            "fields": [
              {
                "key": "site",
                "type": "select",
                "label": "Site",
                "required": true,
                "list": "sites"
              },
              {
                "key": "meter_no",
                "type": "text",
                "label": "Meter number",
                "help": "Printed on the front of the meter",
                "required": true,
                "max_length": 30
              },
              {
                "key": "reading",
                "type": "number",
                "label": "Reading",
                "required": true,
                "min": 0,
                "decimals": 0,
                "unit": "kWh"
              },
              {
                "key": "photo",
                "type": "photo",
                "label": "Photo of the meter",
                "required": false,
                "max_files": 1,
                "source": "any"
              },
              {
                "key": "billing_id",
                "type": "text",
                "label": "Billing record",
                "internal": true
              }
            ]
          }
        ],
        "stages": [
          {
            "key": "received",
            "name": "Received",
            "kind": "open",
            "color": "blue",
            "set_by": [],
            "require_note": false,
            "message": ""
          },
          {
            "key": "queried",
            "name": "Queried",
            "kind": "open",
            "color": "amber",
            "set_by": [],
            "require_note": true,
            "message": "We have a question about your reading {reference}. We will be in touch."
          },
          {
            "key": "checked",
            "name": "Checked",
            "kind": "done",
            "color": "green",
            "set_by": [],
            "require_note": false,
            "message": ""
          }
        ],
        "who": {
          "mode": "anyone",
          "numbers": [],
          "tag": ""
        },
        "trigger": {
          "words": [
            "meter",
            "reading"
          ],
          "header": "",
          "body": "Tap the button to send your reading.",
          "button": "Open form",
          "footer": ""
        },
        "after": {
          "review_step": true,
          "reply": "Thanks {contact.name}. We have your reading - reference {reference}.",
          "allow_additions": false,
          "status_page": true
        },
        "web": {
          "enabled": true,
          "verify": "optional",
          "ask_email": false,
          "success_text": "Thank you. We have your reading."
        },
        "notify": {
          "email": true,
          "to": [],
          "attach_files": true
        },
        "calculated": [
          {
            "key": "usage",
            "label": "Usage",
            "formula": "reading - previous('reading')",
            "unit": "kWh",
            "decimals": 0
          }
        ],
        "retention_days": 0
      }
    }
  ],
  "automations": [
    {
      "name": "Query a reading that looks wrong",
      "form": "meter_reading",
      "enabled": true,
      "trigger": "submitted",
      "options": {},
      "conditions": {
        "any": [
          {
            "field": "usage",
            "lt": 0
          },
          {
            "field": "usage",
            "gt": 2000
          }
        ]
      },
      "actions": [
        {
          "type": "set_status",
          "status": "queried",
          "note": "Usage {usage} kWh is outside the usual range."
        },
        {
          "type": "notify",
          "to": "role:manager",
          "text": "Reading {reference} for meter {meter_no} needs a check: usage {usage} kWh."
        }
      ]
    },
    {
      "name": "Send good readings to billing",
      "form": "meter_reading",
      "enabled": true,
      "trigger": "submitted",
      "options": {},
      "conditions": {
        "all": [
          {
            "field": "usage",
            "gte": 0
          },
          {
            "field": "usage",
            "lte": 2000
          }
        ]
      },
      "actions": [
        {
          "type": "http",
          "connection": "billing",
          "method": "POST",
          "path": "/readings",
          "body": {
            "meter": "{meter_no}",
            "reading": "{reading}",
            "usage": "{usage}",
            "reference": "{reference}",
            "photo": "{files.photo}"
          },
          "save": {
            "billing_id": "$.id"
          },
          "on_fail": "retry"
        },
        {
          "type": "set_status",
          "status": "checked",
          "note": "Sent to billing as {billing_id}."
        }
      ]
    }
  ],
  "publish": [
    "meter_reading"
  ]
}

Azịza nke oku n'ezie (na-enweghị dry_run):

{
  "success": true,
  "request_id": "req_...",
  "applied": {
    "lists": [
      "sites"
    ],
    "connections": [
      "billing"
    ],
    "forms": [
      "meter_reading"
    ],
    "automations": [
      "Query a reading that looks wrong",
      "Send good readings to billing"
    ],
    "published": [
      "meter_reading"
    ]
  },
  "problems": []
}

Oku ndị ọzọ

  • Ntọala: GET / PUT /submit/settings.
  • Fom: ndepụta, mepụta (site na nkọwa ma ọ bụ template), gụọ, melite, hichapụ, bipụta, na POST /submit/forms/{key}/send iji zipu fom gaa nọmba ọ bụla na uru ejuputara.
  • Ndepụta: PUT /submit/lists/{key} na-edochi ahịrị nke ndepụta.
  • Ndabanye: ndepụta (ị nwere ike ịchọ site na fom, ọkwa, onye e kenyere, tag, ụzọ, kọntaktị, ederede na ụbọchị; updated_after maka mmekọrita; CSV site na ?format=csv), mepụta, gụọ site na id ma ọ bụ reference, melite (ọkwa, ndetu, mkpa, onye e kenyere, oge ịga, tags, azịza, ubi dị n'ime), tinye ndetu, zaghachi na bọtịnụ, tinye faịlụ, hichapụ.
  • Akpaaka na ndị na-agba ọsọ: ndepụta, gụọ, melite, mepụta, hichapụ, POST /submit/automations/try, na akụkọ ndị na-agba ọsọ.
  • Njikọ: ndepụta, tinye, hichapụ, nwalee, mee ka ọhụrụ, na ọrụ omume ọ nwere ike ikpọ.
  • Ndị otu na akụkọ: kpọọ, melite na wepụ ndị otu; ọnụọgụgụ site na fom, ọkwa, ụbọchị na onye e kenyere.

Ihe ntinye webhook

Webhook ọ bụla nke akaụntụ gị na-anata ihe omume ọ bụla. Ọ bụla n'ime ha na-ebu ndabanye dịka ọ dị n'oge ahụ: njikọ faịlụ nọ na ya na-arụ ọrụ ruo ụbọchị 7.

Ihe omumeMgbe
submission.createdndabanye adịla (faịlụ ya nwere ike ka na-abata)
submission.files_readya debere faịlụ ya
submission.updatedazịza, uru dị n'ime, mkpa, tags ma ọ bụ oge ịga gbanwere
submission.status_changedọkwa gbanwere
submission.assignedonye e kenyere ya gbanwere
submission.note_addeda dere ndetu
submission.customer_repliedonye ahụ tinyere ederede, faịlụ ma ọ bụ ihe na-esochi, ma ọ bụ pịa bọtịnụ
submission.deletedehichapụrụ ya ma ọ bụ ehichapụrụ ya n'ụzọ ọ bụla
submit.automation_failedakpaaka kwụsịrị mgbe nnwale ọzọ gasịrị

Ngwa ọrụ MCP

Ọrụ ọ bụla bụkwa ngwa ọrụ na MCP server a na-enyere app2email, ya mere onye enyemaka nwere ike ime nhazi zuru ezu n'okwu: get_submit_guide, apply_submit_setup, list_submit_presets, create_form, publish_form, send_form, list_submissions, get_submission, update_submission, reply_to_submission, create_automation, try_automation, set_connection, test_connection na ndị ọzọ. Ozi mbụ dị mma gaa onye enyemaka: "Gụọ nkuzi Submit-Info, mgbe ahụ hazie fom akụkọ nsogbu nwere foto na ebe, gwa ndị manager m ihe ndị mkpa."

claude mcp add --transport http app2email https://api.app2email.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Ọzọ gbasara ijikọ ndị enyemaka na ngwa ọrụ akpaaka: Automation tools and agents.

Oke

OkeUru
Fom na nọmba100
Nzọụkwụ na fom, ajụjụ na nzọụkwụ12 na 12 (ajụjụ 60 na fom, otu ajụjụ ebe)
Ndepụta50, ọ bụla ruo 1,000 ahịrị
Akpaaka, njikọ, ndị otu200, 30, 200
Faịlụ n'otu ndabanye60
Ogo faịlụ25 MB site na WhatsApp, 10 MB site na ibe weebụ ma ọ bụ API
Ndetu ma ọ bụ azịzamkpụrụedemede 4,000
Tags na ndabanye20
Oku gaa sistemụ ọzọ60 kwa nkeji na 2,000 kwa ụbọchị kwa nọmba; sekọnd 15 na 256 KB kwa oku
Akụkọ ịgba ọsọa na-echekwa ya ụbọchị 30

Ọ dịghị adịkwa ugbu a

  • Ịkwụ ụgwọ n'ndabanye (a na-anabata ọnụahịa, a naghị akwụ ya).
  • Izipu fom onye na-adịghị ede gị n'ime awa 24 gara aga dị ka fom WhatsApp: ị na-enweta njikọ weebụ nke onwe ya maka onye ahụ, iji zipu ya site na template a kwadoro ọ bụla.
  • Mbinye aka.
  • Otu ndị ugboro ugboro ("add another item").
  • Ịga fom ọzọ n'etiti ya.
  • Ijuputa fom na-enweghị njikọ.
  • Asụsụ ndọrọ ndọrọ na ederede edobere nke ibe weebụ (ederede fom gị niile bụ nke gị ide).
  • Akwụkwọ OpenAPI n'ụdị YAML ma ọ bụ Swagger 2, na MCP servers nke na-asụ naanị ụdị SSE ochie.
  • Ịgụ uru site na foto.

Ihe niile dị n'elu a na-edozi na ibe Submit-Info nke dashboard (/dashboard/app/submit). Ajụjụ: support@app2email.com.