app2email API Farashi

Takardu

Submit-Info

Jagorar Submit-Info: gina fom daga jerin tambayoyi, buga shi a WhatsApp da shafin yanar gizo, aiki da ƙaddamarwa ta matakai a akwatin saƙo na bai ɗaya tare da matsayi, sarrafa amsoshi da kira zuwa tsarin ka, da saita komai ta API ko wakilin AI.

Kana rubuta fom a matsayin jerin tambayoyi mai sauƙi. app2email yana mayar da shi fom a cikin WhatsApp da shafin yanar gizo mai matakai iri ɗaya. Abokin ciniki, ko ma'aikacin filinka, yana cike shi yana samun lambar magana. Amsoshi da fayiloli suna zama ƙaddamarwa a akwatin saƙo na bai ɗaya, inda take motsawa ta matakanka kuma tana kunna atomatik ɗinka.

Ra'ayi ɗaya

Fom, sannan ƙaddamarwa, sannan matakai, sannan atomatik, sannan haɗi. Buƙatar farashi, aikace-aikace, karatun mita, rahoton matsala, aikin da aka kammala, shaidar isarwa da rasit na kashe kuɗi duk abu ɗaya ne da tambayoyi da sunayen matakai daban-daban. Kowanne yana zuwa a matsayin samfuri da za ka iya sanyawa da canjawa.

Fara cikin mintuna biyar

  1. Buɗe shi: a dashboard ɗinka buɗe shafin Submit-Info (/dashboard/app/submit, ana kuma buɗe shi daga Integrations). Kunna shi.
  2. Ƙirƙiri fom: zaɓi "New form" ka zaɓi samfuri, ko fara daga fanko. Ba shi suna ka rubuta tambayoyinka. Kowace tambaya layi ɗaya ce: rubutunta, nau'insa, da ko dole ne a amsa ta.
  3. Buga: "Publish to WhatsApp" yana loda fom zuwa WhatsApp kuma yana sa shi aiki. Shafin yanar gizo mai matakai iri ɗaya yana aiki nan take.
  4. Raba: a ƙarƙashin Share za ka sami kalmar da ke buɗe fom a hirarka, hanyar da ke buɗe hirarka da kalmar a rubuce, adireshin shafin yanar gizo, QR code, da ɗan lambar sa fom a shafin yanar gizonka.
  5. Yi aiki da akwatin saƙo: sababbin ƙaddamarwa suna shiga Inbox. Buɗe ɗaya, canja matakinsa, amsa. Gayyaci ƙungiyarka idan ka shirya.

Babu abin da ke canzawa ga lambar da ba ta taɓa buɗe Submit-Info ba. Fom da ba a buga shi a WhatsApp ba tukuna har yanzu yana aiki: kalmarsa tana amsawa da hanyar shafin yanar gizo.

Mai gina fom

Fom yana da matakai 1 zuwa 12, kuma kowane mataki yana da take da tambayoyi 1 zuwa 12. Babu zane ko zana: jerin ɗaya yana tuƙa fom ɗin a WhatsApp, shafin yanar gizo, duba amsoshi, ginshiƙan ra'ayin tebur, fitarwa da API. Samfotin da ke gefen edita yana nuna fom yadda mutum yake ganinsa.

Nau'iAbin da mutum ke bayarwaAbin da za ka iya saitawa
textGajeren amsamafi guntu da mafi tsayi, tsari
textareaDoguwar amsamafi guntu da mafi tsayi
numberLambamafi ƙanƙanta da mafi girma, ƙananan lambobi bayan waƙafi, raka'a kamar kWh
emailAdireshin imel
phoneLambar waya
dateRananawa kwanaki baya ko gaba ana iya
selectZaɓi ɗayazaɓuɓɓuka (2 zuwa 200), ko jerinka
multiselectZaɓi da yawazaɓuɓɓuka (2 zuwa 20), mafi ƙarancin da mafi yawan da za a duba
yesnoEh ko A'a
ratingMaki daga 1 zuwa 3-10mafi girman maki
consentJumla da za a yarda da itako dole ne a duba ta
photoHoto ɗaya ko fiyenawa (1 zuwa 10); kyamara, gallery ko duka biyu
documentFayil ɗaya ko fiyenawa (1 zuwa 10); kowane fayil, PDF, hotuna ko fayilolin ofis
locationInda mutum yakea WhatsApp buƙatar wuri; a yanar gizo maɓalli da layin adireshi
infoRubutun da kake nunawaba a tambaya ko adana komai ba
hiddenƘima da ke zuwa tare da hanyarkamar lambar aiki; ba a nuna komai ba
  • Rubutun taimako da ƙimar tsoho: kowace tambaya tana iya ɗaukar ɗan shawara, da ƙimar tsoho. Ƙimar tsoho na iya amfani da abin da ka riga ka sani, kamar {contact.name}.
  • Nuna kawai idan: mataki ko tambaya na iya dogara da amsar da ta gabata ("nuna wannan mataki kawai idan Problem shine Yes"). WhatsApp da shafin yanar gizo suna bin doka iri ɗaya.
  • Filayen cikin gida: filayen da ba a taɓa tambaya ba. Ƙungiyarka ko atomatik suna cika su: adadin farashi, dalilin yanke shawara, id da ya dawo daga wani tsarin. Suna nunawa a akwatin saƙo da fitarwa kawai.
  • Jeri: tambayar zaɓi na iya ɗaukar zaɓuɓɓukanta daga jerinka (wurare, ayyuka, kayayyaki da farashi). Canja jerin a dashboard ko ta API sai fom ɗin ya bi, ba tare da buƙatar sake bugawa ba.
  • Ƙimar lissafi: dabara akan amsoshi, don ƙiyasi nan take ko duba. Duba dabaru.
  • Bayan aikawa: allon dubawa kafin aikawa, amsa da lambar magana, maɓallin "Add more" da ke haɗa saƙonni na gaba (rubutu, hotuna, fayiloli) ga ƙaddamarwar na minti goma, da hanyar shafin matsayin mutum.
  • Bugawa: app2email yana rubuta fom ɗin WhatsApp maka, yana raba doguwar mataki zuwa allo da yawa idan iyakokin WhatsApp suna buƙata, kuma yana riƙe sigogi biyar na ƙarshe da aka buga don tsohon saƙo har yanzu ya buɗe fom ɗin da aka aika da shi.

Shafin yanar gizo. Matakai iri ɗaya a /form/your-code/form-key. Yana tambayar suna da lambar WhatsApp a ƙarshe. Bayan aikawa, mutum yana ganin lambar magana kuma yana iya danna "Get updates on WhatsApp", wanda ke tabbatar da lambarsa da saƙo ɗaya; ana iya saita fom ya buƙaci hakan. Hanyar kai (wadda ka aika) tuni ta san wanda mutum yake. Don saka fom a shafinka, yi amfani da ɗan lambar da ke ƙarƙashin Share; idan fom ɗin yana neman wuri, ƙara allow="geolocation" a iframe. Ana rage hotuna a browser kafin a loda su; fayil zai iya kaiwa MB 10.

Yadda mutane ke isa fom

  • Kalma: kowane fom yana da kalmominsa. Kalmomin form, forms, report da submit (zaka iya canza su) suna lissafa fom ɗinka a matsayin menu idan akwai da yawa. Kalma tana ƙidaya ne kawai a gajeren saƙo: wanda ke da ƙasa da kalmomi 10 (Settings, "Ignore the words in long messages"), don haka doguwar saƙo da ta ƙunshe ta ba ta fara komai ba.
  • Hanyar ko QR code: hanyar da ke buɗe hirar WhatsApp ɗinka da kalmar fom, ko adireshin shafin yanar gizo.
  • Ka aika: "Send form" a akwatin saƙo, ko API, yana aika fom zuwa lamba ɗaya, da ƙimomi da aka riga aka cike (lambar aiki, asusu, takardun da kake so).
  • Bibiya: atomatik ko memba na ƙungiya yana neman ƙari da fom na biyu. Abin da ya dawo yana haɗuwa da ƙaddamarwar farko.
  • Shafin yanar gizo, da API ga tsarin da suke riƙe da bayanan.

Wanda zai iya aikawa. Kowa (zaɓin da aka saba), ko lambobin da ka jera kawai ko abokan hulɗa da alamarka. Ta haka fom ke zama tare da ma'aikatan filinka. Kalmar status tana amsa mutum da matakin ƙaddamarwarsa ta kwanan nan.

Matakai

Matakai na fom ne. Sabon fom yana farawa da New, In progress da Done; canza sunayensu, ƙara naka (2 zuwa 12), kuma zaɓi launi. Kowane mataki ɗaya ne daga cikin nau'i uku: a buɗe, an kammala ko an soke.

  • Wanda zai iya zaɓa: ajiye mataki don wasu matsayi. Agent yana shiryawa, Manager kaɗai ke amincewa.
  • Ana buƙatar bayani: a nemi dalili idan an motsa ƙaddamarwa zuwa wurin (an ƙi, an hana, an tambaya).
  • Saƙo: rubutu da ake aika wa mutum idan ƙaddamarwarsa ta isa matakin, tare da placeholders.
  • Maɓallai ga mutum: amsa na iya ɗaukar maɓalli har uku (Accept, Decline, "Not fixed yet"), kuma kowane yana motsa mataki. Wannan ɗaya kawai yana ba ka karɓar farashi, tabbatar da ziyara da "an gyara ne?".

Amsar da aka rubuta a wajen lokacin amsa na WhatsApp ana ajiye ta kuma ana isar da ita idan mutum ya sake rubutawa. Akwatin saƙo yana faɗin haka a kan amsar.

Akwatin saƙo da matsayi

Inbox tana nuna Open, Mine, Unassigned, Done da All, tare da ra'ayoyin da ka adana. Bincika da tace ta fom, mataki, wanda aka ba aiki, alama, tasha da kwanan wata. Tsare-tsare uku: jeri, tebur (fom ɗaya: kowace tambaya ginshiƙi ce) da allo (fom ɗaya: ginshiƙi ga kowane mataki). Duba layuka da yawa don canja mataki, ba da aiki, sanya alama, fitarwa ko share su tare.

Ƙaddamarwa tana nuna amsoshinta, fayilolinta, daga inda aka aika ta, da tarihi ɗaya na duk abin da ya faru da ita: canje-canjen mataki tare da wanda da dalili, bayanin kula, amsoshi ta bangarori biyu, fayiloli, da kowane mataki na atomatik tare da sakamakonsa. A ƙasa kana rubuta ko bayanin cikin gida ko amsar WhatsApp. Fitar da kowane ra'ayi a matsayin CSV, Excel ko JSON, da ƙaddamarwa ɗaya a matsayin PDF.

Ƙungiyarka. Gayyaci mutane ta imel zuwa akwatin saƙo kawai. Suna samun ƙaramin app nasu a /desk kuma ba sa ganin sauran asusunka. Matsayi shi ne saitin iyawa na farko, kuma ana iya kunna ko kashe kowace iyawa ga mutum ɗaya.

MatsayiYana farawa da
Owner, AdminKomai, har da fom, atomatik, haɗi da ƙungiya
ManagerBayanan kula, amsoshi, gyara amsoshi, canja mataki, ba da aiki, fayiloli, fitarwa, share, gudanar da ayyukan hannu
AgentBayanan kula, amsoshi, gyara amsoshi, canja mataki, fayiloli, gudanar da ayyukan hannu. Yana iya ɗaukar ƙaddamarwa don kansa
ViewerZai iya karantawa kawai, ba komai

Haka kuma za ka iya takaita abin da mutum ke gani: wasu fom kawai, abin da aka ba shi kawai (tare da ko babu waɗanda ba a ba wa kowa ba don ɗauka), da ɓoye bayanan tuntuɓar. Kowane aiki na memba na ƙungiya ana rubuta shi a tarihin ƙaddamarwar.

Shafin mutum da kansa. Kowace ƙaddamarwa tana da shafi na sirri a /s/a-long-code, ba tare da shiga ba: matakin, saƙonni da canje-canjen mataki zuwa yanzu, tambayarka a buɗe da maɓallanta, da "Add information" idan fom ɗin ya ba da dama. Bayanan cikin gida da filayen cikin gida ba a taɓa sanya su a kansa ba.

Sirri. Goge abokin hulɗa yana goge ƙaddamarwarsa da fayilolinsa. Fom na iya samun lokacin ajiya, bayan haka ana goge ƙaddamarwar da aka rufe.

Atomatik

Atomatik ana karanta shi kamar jumla: lokacin da wani abu ya faru, idan wasu abubuwa gaskiya ne, yi waɗannan abubuwa cikin tsari. "Lokacin da aka aika Quote request, idan yawan ya kai 20 ko fiye, a ba wa Managers shi kuma a aika wa mai shi imel."

Lokacin daYana gudana idan
submittedan kammala ƙaddamarwa kuma fayilolinta sun iso
status_changedmataki ya canja (a zaɓi: zuwa ko daga wasu matakai)
assignedmutumin da aka ba wa aiki ya canja
updatedan gyara amsoshi ko filayen cikin gida
note_addedmemba na ƙungiya ya rubuta bayani
file_addedan ƙara fayil daga baya
customer_repliedmutumin da ya aika ya ƙara rubutu ko fayiloli
buttonmutum ya danna maɓalli na ɗaya daga amsoshinka
overduehar yanzu yana cikin mataki ɗaya bayan wasu mintuna
duelokacin ƙarewarsa ya wuce yayin da yake a buɗe
manualmemba na ƙungiya ya danna maɓallin aikin a kan ƙaddamarwar

In: dokoki akan amsoshi, ƙimomin lissafi, mataki, tasha, alamomi da wanda aka ba aiki. Doka tana da filin, mai aiki da ƙima: equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte. Haɗa dokoki da all (da) ko any (ko).

YiAbin da yake yi
set_statusmotsa shi zuwa mataki, tare da bayani
assignga memba, bi-da-bi a cikin matsayi, ga mafi ƙarancin aiki a matsayi, ko ga kowa ba
set_field, calculaterubuta filin cikin gida, ko lissafa shi da dabara
tag, set_priority, set_duealamomi, fifiko, lokacin ƙarewa
replysaƙon WhatsApp ga mutum, tare da maɓalli har 3 da kowannensu ke motsa mataki, fayil, ko hanyar shafin matsayinsa
ask_locationa nemi mutum ya raba inda yake
send_formaika fom na bibiya; abin da ya dawo yana haɗuwa da wannan ƙaddamarwa
emailga mai shi, wanda aka ba aiki, mutum, ko kowane adireshi, tare da fayiloli a haɗe
notifyimel ga wanda aka ba aiki, matsayi, ko kowa a ƙungiya
http, openapi, mcpkira haɗi kuma ajiye sassan amsar a filaye
waitci gaba daga baya, kawai idan sharuɗɗan har yanzu suna aiki
stopƙare a nan

Kowane gudu ana rubuta shi mataki-mataki: abin da aka aika, abin da ya dawo, tsawon lokacin da ya ɗauka. "Try with a submission" yana gudanar da atomatik a kan ƙaddamarwa ta gaske ba tare da canzawa ko aika komai ba. Kiran tsarin waje da ya kasa ana sake gwada shi bayan minti 1, minti 10 da awa 1; bayan haka ana yiwa atomatik alama a matsayin wanda ya kasa kuma webhooks ɗinka suna samun submit.automation_failed. Atomatik da ke kunna juna ana dakatar da su bayan matakai uku.

Girke-girke 1: manyan farashi suna zuwa ga manager

{
  "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
    }
  ]
}

Girke-girke 2: aika farashi, nemi amsa, tunatarwa bayan kwana uku

quote_amount filin cikin gida ne da ƙungiyarka ke cikawa kafin ta motsa ƙaddamarwa zuwa Quoted. Tunatarwa tana fita ne kawai idan ƙaddamarwar har yanzu tana cikin 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."
    }
  ]
}

Girke-girke 3: ajiye karatun mita da ya zama kuskure

usage ƙimar lissafi ce: 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."
    }
  ]
}

Haɗi

Haɗi tsari ne na waje da atomatik zai iya kira. Webhooks na asusunka ba sa buƙatar haɗi: suna karɓar kowane taron ƙaddamarwa yayin da yake faruwa (duba abubuwan da suka faru). Don sauran komai akwai nau'i uku. "Test" a kan haɗi, da "Try with a submission" a kan aiki, suna nuna buƙatar gaske da amsar gaske kafin a kunna komai.

Buƙatar HTTP

Adireshin tushe da hanyar shiga (babu, bearer token, header, suna mai amfani da kalmar sirri, ko key a cikin adireshi). Aikin yana ambaton hanya, hanyar fayil, da JSON body. save yana ajiye sassan amsar a filayen ƙaddamarwar.

{
  "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"
}

Takardar OpenAPI

Ba da adireshin takardar OpenAPI 3 a JSON, ko liƙa ta. app2email yana karanta ayyukanta; aikin yana zaɓar ɗaya ta id ɗinsa kuma yana cika sigoginsa. Takardun YAML da Swagger 2 ba a karanta su.

{
  "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

Ba da adireshin MCP server (streamable HTTP) da token ɗinsa. app2email yana lissafa kayan aikin server; aikin yana zaɓar ɗaya yana cika muhawararsa. $text yana ajiye dukan amsar kayan aikin a matsayin rubutu.

{
  "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"
}

Abin da ya kamata ka sani. Ƙima da ta zama placeholder ɗaya kawai tana riƙe nau'inta (lamba tana zama lamba, jeri yana zama jeri). Sirri ana adana su a ɓoye, ba a sake nuna su ba kuma API ba ya mayar da su. Adireshi dole ne ya zama https kuma na jama'a: ana ƙi adireshi na sirri, na gida da na ciki, kuma ba a bi redirects ba. Kira na iya ɗaukar daƙiƙa 15 kuma amsarsa na iya zama KB 256. A save, hanya ita ce $ (dukan amsar) ko hanya mai sauƙi kamar $.data.items[0].id.

Placeholders

Kowane rubutu da kowace sigar aiki na iya amfani da placeholders a cikin ƙugiya masu lanƙwasa. Sunan da ba a sani ba yana zama yadda ka rubuta shi.

PlaceholderYana zama
{<field key>}amsar wannan tambayar (har da filayen cikin gida, ƙimomin lissafi da ƙimomin da atomatik ya adana)
{reference}lambar magana, misali MR-7Q3M2A
{form} {form_key}sunan fom da key ɗinsa
{status} {status_name}key ɗin mataki da sunansa
{channel}whatsapp, web, api ko staff
{priority} {tags}fifiko da alamomi
{created} {updated} {due}lokutan
{contact.name} {contact.phone} {contact.email}mutumin da ya aika ta
{assignee.name} {assignee.email}memba na ƙungiyar da aka ba aiki
{link}shafin matsayin mutum
{desk_link}ƙaddamarwar a akwatin saƙon ƙungiyarka
{answers}dukan amsoshi a matsayin layuka "Label: value"
{files} {files.<field key>}hanyoyin dukan fayiloli, ko na tambaya ɗaya; wani tsari zai iya ɗaukar su na kwanaki 7
{note}bayanin canjin mataki, ko bayanin da ya kunna atomatik ɗin
{button}maɓallin da mutum ya danna
{business}sunan kasuwancinka
{submission}a JSON body: dukan ƙaddamarwar a matsayin abu
{= formula }dabara da aka lissafa a wurin, misali {= round(qty * 1.1, 2) }

Dabaru

Ana amfani da su ta ƙimomin lissafi, ta aikin calculate, da cikin {= ... } a kowane rubutu. Dabara tana aiki da lambobi, rubutu a cikin ƙananan ƙugiyoyi da keys ɗin tambayoyinka. Tana iya kaiwa haruffa 500. Rarraba da sifili, ko lambar da ba ta nan, tana ba da ƙima mara komai maimakon kuskure.

Ka rubutaMa'ana
+ - * / %lissafi akan lambobi da amsoshi
== != > >= < <=kwatance
and or not ( )ma'ana da ƙugiyoyi
if(condition, a, b)a idan sharadi ya tabbata, in ba haka ba b
min(a, b, ...) max(a, b, ...)mafi ƙanƙanta, mafi girma
round(x, n) abs(x)zagayawa zuwa n ƙananan lambobi, girman lamba ba tare da alamarta ba
num(x) len(x)rubutu a matsayin lamba; tsawon rubutu ko jeri
coalesce(a, b)a, ko b idan a babu komai
lower(x) upper(x) concat(a, b, ...)rubutu
lookup('list', id, 'column')ginshiƙi na layi a jerinka, misali farashi
previous('field')amsar mutumin ta ƙarshe ga wannan tambaya
count_files('field')nawa fayiloli tambaya ke ɗauke da su
days_since(date)kwanaki daga rana zuwa yau

Misalai: qty * lookup('prices', product, 'price') don ƙiyasi nan take; reading - previous('reading') don amfani; if(amount > 500, 'manager', 'agent') don yanke shawarar wanda zai amince.

Ga masu haɓakawa da wakilan AI

Komai da ke sama yana cikin REST API ƙarƙashin /v1/{number}/submit, inda {number} shine lambar WhatsApp ɗinka tare da lambar ƙasa, lambobi kawai. Aika API key ɗinka a matsayin Authorization: Bearer YOUR_API_KEY (header X-API-KEY ma ana karɓarsa). Key yana buƙatar scope submissions:manage; keys masu cikakken shiga suna da shi, Default key ba shi da shi. Sandbox keys ba sa iya rubutawa.

  1. GET /submit/guide: takarda ɗaya ta JSON mai dukan kalmomi: nau'in tambayoyi tare da zaɓuɓɓukansu da iyakokinsu, dokokin matakai, masu kunnawa, masu aiki, ayyuka tare da sigoginsu, placeholders, ayyukan dabara, samfura, da misalai da aka yi.
  2. POST /submit/setup tare da "dry_run": true: ba a rubuta komai ba; kowace matsala tana dawowa da hanyarta da jumlar yadda za a gyara ta.
  3. POST /submit/setup ba tare da dry_run ba: jeri, haɗi, fom da atomatik ana aiwatar da su tare. Idan akwai wata matsala, ba a rubuta komai ba.
  4. POST /submit/forms/{key}/publish, ko ka ambaci fom ɗin a cikin "publish" na takardar saiti.
  5. Raba hanyoyin fom (GET /submit/forms/{key} yana dawo da su), sannan karanta GET /submit/submissions ko saurari abubuwan webhook.

Cikakken kira na saiti

Ajiye takardar da ke ƙasa a matsayin setup.json kuma aika ta. Maye gurbin 61400000000 da lambarka. Tana duba maganin karatun mita: jerin wurare, haɗi zuwa tsarin lissafin kuɗi, fom ɗaya tare da matakai uku da amfani da aka lissafa, da atomatik biyu. Cire "dry_run": true don aiwatarwa. Fom, jeri da haɗi da suke da key iri ɗaya ana maye gurbinsu; ana daidaita atomatik da suna a cikin fom ɗin. "preset": "..." a maimakon sassan yana shigar da ɗaya daga cikin samfuran (GET /submit/presets yana lissafa su).

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"
  ]
}

Amsar kiran gaske (ba tare da dry_run) ita ce:

{
  "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": []
}

Sauran hanyoyi

  • Settings: GET / PUT /submit/settings.
  • Forms: jeri, ƙirƙira (daga ma'ana ko samfuri), karatu, sabuntawa, sharewa, bugawa, da POST /submit/forms/{key}/send don aika fom zuwa lamba tare da ƙimomin da aka cika.
  • Lists: PUT /submit/lists/{key} yana maye gurbin layukan jeri.
  • Submissions: jeri (tacewa ta fom, mataki, wanda aka ba aiki, alama, tasha, lamba, rubutu da kwanaki; updated_after don daidaitawa; CSV da ?format=csv), ƙirƙira, karatu ta id ko lambar magana, sabuntawa (mataki, bayani, fifiko, wanda aka ba aiki, lokacin ƙarewa, alamomi, amsoshi, filayen cikin gida), ƙara bayani, amsa da maɓalli, ƙara fayil, sharewa.
  • Atomatik da gudu: jeri, ƙirƙira, karatu, sabuntawa, sharewa, POST /submit/automations/try, da log ɗin gudu.
  • Haɗi: jeri, saita, sharewa, gwaji, sabuntawa, da ayyukan da aiki zai iya kira.
  • Ƙungiya da rahoto: gayyata, sabuntawa da cire membobi; ƙidaya ta fom, mataki, rana da wanda aka ba aiki.

Abubuwan webhook

Kowane webhook na asusunka yana samun kowane taron. Kowane ɗaya yana ɗauke da ƙaddamarwar yadda take a wannan lokacin; hanyoyin fayiloli a cikinsa suna aiki na kwanaki 7.

TaronLokacin
submission.createdƙaddamarwa ta wanzu (fayilolinta na iya kasancewa suna zuwa)
submission.files_readyan adana fayilolinta
submission.updatedamsoshi, ƙimomin cikin gida, fifiko, alamomi ko lokacin ƙarewa sun canja
submission.status_changedmataki ya canja
submission.assignedwanda aka ba aiki ya canja
submission.note_addedan rubuta bayani
submission.customer_repliedmutum ya ƙara rubutu, fayiloli ko bibiya, ko ya danna maɓalli
submission.deletedan share ko an goge
submit.automation_failedatomatik ya daina bayan sake gwadawa

Kayan aikin MCP

Kowace hanya kuma kayan aiki ce a MCP server na app2email da aka ɗora, don mataimaki ya yi dukan saitin a cikin hira: 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 da sauransu. Kyakkyawan saƙo na farko ga mataimaki: "Karanta jagorar Submit-Info, sannan ka saita fom na rahoton matsala tare da hotuna da wuri, kuma ka faɗa wa managers ɗina game da gaggawa."

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

Ƙarin bayani kan haɗa mataimaka da kayan atomatik: Automation tools and agents.

Iyakoki

IyakaƘima
Fom a kowace lamba100
Matakai a cikin fom, tambayoyi a cikin mataki12 da 12 (tambayoyi 60 a cikin fom, tambayar wuri ɗaya)
Jeri50, kowanne har layuka 1,000
Atomatik, haɗi, membobin ƙungiya200, 30, 200
Fayiloli a ƙaddamarwa ɗaya60
Girman fayilMB 25 daga WhatsApp, MB 10 daga shafin yanar gizo ko API
Bayani ko amsaharuffa 4,000
Alamomi a ƙaddamarwa20
Kira zuwa tsarin waje60 a minti da 2,000 a rana a kowace lamba; daƙiƙa 15 da KB 256 a kowane kira
Log ɗin guduana adana shi kwanaki 30

Ba a samu ba tukuna

  • Karɓar biyan kuɗi a kan ƙaddamarwa (ana karɓar farashi, ba a biya ba).
  • Aika fom ga wanda bai rubuta maka ba a cikin awanni 24 na ƙarshe a matsayin fom na WhatsApp: a maimakon haka za ka sami hanyar yanar gizonsa ta kai, don aika da kowane samfuri da aka amince da shi.
  • Sa hannu.
  • Ƙungiyoyin maimaituwa ("ƙara wani abu").
  • Tsalle zuwa wani fom a tsakiya.
  • Cika fom ba tare da haɗi ba.
  • Sauran harsuna a cikin rubutun da aka gyara na shafin yanar gizo (kowane rubutu na fom ɗinka naka ne ka rubuta).
  • Takardun OpenAPI a YAML ko Swagger 2, da MCP servers da ke amfani da tsohuwar hanyar SSE kawai.
  • Karanta ƙima daga hotuna.

Komai da ke sama ana saita shi a shafin Submit-Info na dashboard (/dashboard/app/submit). Tambayoyi: support@app2email.com.