app2email API Presyo

Dokumentasyon

Submit-Info

Ang gabay sa Submit-Info: gumawa ng form mula sa listahan ng mga tanong, ilathala ito sa WhatsApp at sa web page, iproseso ang mga submission sa mga yugto sa shared na inbox na may mga tungkulin, mag-automate ng mga sagot at tawag sa sarili ninyong mga sistema, at i-set up ang lahat sa pamamagitan ng API o ng AI agent.

Isinusulat ninyo ang form bilang simpleng listahan ng mga tanong. Ginagawa ito ng app2email na form sa loob ng WhatsApp at isang web page na may parehong mga hakbang. Ang customer, o isang miyembro ng sarili ninyong field staff, ang nagpupuno nito at nakakakuha ng reference. Ang mga sagot at file ay nagiging submission sa shared na inbox, kung saan ito dumadaan sa mga yugto ninyo at nagpapatakbo ng mga automation ninyo.

Isang ideya

Form, pagkatapos submission, pagkatapos mga yugto, pagkatapos automation, pagkatapos koneksyon. Ang kahilingan ng quote, aplikasyon, pagbabasa ng metro, ulat ng problema, natapos na trabaho, patunay ng paghahatid at resibo ng gastos ay iisang bagay lang na magkakaiba ang mga tanong at pangalan ng yugto. Bawat isa ay dumarating bilang template na maaari ninyong i-install at baguhin.

Magsimula sa loob ng limang minuto

  1. Buksan ito: sa dashboard, buksan ang Submit-Info page (/dashboard/app/submit, mabubuksan din mula sa Integrations). I-on ito.
  2. Gumawa ng form: piliin ang "New form" at pumili ng template, o magsimula sa blangko. Bigyan ito ng pangalan at isulat ang mga tanong. Ang bawat tanong ay isang hanay: ang teksto nito, ang uri nito, at kung kailangan itong sagutin.
  3. Ilathala: ina-upload ng "Publish to WhatsApp" ang form sa WhatsApp at ginagawa itong live. Agad na live ang web page na may parehong mga hakbang.
  4. Ibahagi: sa ilalim ng Share, makikita ninyo ang salitang nagbubukas ng form sa chat, isang link na nagbubukas ng chat ninyo na may nakatype nang salitang iyon, ang address ng web page, isang QR code, at isang snippet para ilagay ang form sa sarili ninyong website.
  5. Asikasuhin ang inbox: ang mga bagong submission ay dumarating sa Inbox. Buksan ang isa, baguhin ang yugto nito, at sumagot. Imbitahan ang team ninyo kapag handa na kayo.

Walang nagbabago para sa numerong hindi kailanman nagbubukas ng Submit-Info. Gumagana pa rin ang form na hindi pa nailalathala sa WhatsApp: ang salita nito ay sumasagot ng link ng web page.

Ang form builder

Ang form ay may 1 hanggang 12 hakbang, at ang hakbang ay may pamagat at 1 hanggang 12 tanong. Walang canvas at walang iguguhit: ang parehong listahan ang nagpapatakbo ng form sa WhatsApp, ng web page, ng mga pagsusuri sa mga sagot, ng mga hanay ng table view, ng mga export, at ng API. Ang preview sa tabi ng editor ay nagpapakita ng form gaya ng pagkakita ng tao rito.

UriAng ibinibigay ng taoAno ang maitatakda ninyo
textMaikling sagotpinakamaikli at pinakamahabang haba, isang pattern
textareaMas mahabang sagotpinakamaikli at pinakamahabang haba
numberIsang numeropinakamababa at pinakamataas na halaga, decimal, isang yunit gaya ng kWh
emailIsang email address
phoneIsang numero ng telepono
dateIsang petsailang araw pabalik o pasulong ito maaaring
selectIsang pagpipilianang mga pagpipilian (2 hanggang 200), o isang listahan ninyo
multiselectMaraming pagpipilianang mga pagpipilian (2 hanggang 20), pinakakaunti at pinakamaraming maaaring piliin
yesnoOo o Hindi
ratingIsang marka mula 1 hanggang 3-10ang pinakamataas na marka
consentIsang pangungusap na sasang-ayunankung kailangang lagyan ng tsek
photoIsa o higit pang larawanilan (1 hanggang 10); camera, gallery o alinman
documentIsa o higit pang fileilan (1 hanggang 10); anumang file, PDF, mga larawan o office file
locationKung nasaan ang taosa WhatsApp ang hiling ng lokasyon; sa web ay isang button at linya ng address
infoTekstong ipinapakita ninyowalang tinatanong o itinatago
hiddenHalagang kasama ng linkgaya ng numero ng trabaho; walang ipinapakita
  • Teksto ng tulong at mga default: bawat tanong ay maaaring may maikling pahiwatig, at isang default na halaga. Maaaring gamitin ng default ang alam na ninyo, gaya ng {contact.name}.
  • Ipakita lamang kapag: ang isang hakbang o tanong ay maaaring nakasalalay sa naunang sagot ("ipakita ang hakbang na ito lamang kapag Oo ang Problem"). Pareho ang sinusunod ng WhatsApp at ng web page.
  • Internal na field: mga field na hindi kailanman itinatanong. Pinupuno ito ng team ninyo o ng isang automation: halaga ng quote, dahilan ng desisyon, isang id na bumalik mula sa ibang sistema. Lumalabas lamang ang mga ito sa inbox at sa mga export.
  • Mga listahan: ang tanong na pagpipilian ay maaaring kunin ang mga pagpipilian nito mula sa isang listahan ninyo (mga site, trabaho, produkto na may presyo). Palitan ang listahan sa dashboard o sa pamamagitan ng API at susundan ito ng form, nang walang kailangang ilathala ulit.
  • Mga kinakalkula na halaga: isang pormula sa ibabaw ng mga sagot, para sa agarang tantiya o pagsusuri. Tingnan ang mga pormula.
  • Pagkatapos magpadala: isang screen ng pagsusuri bago ipadala, ang sagot na may reference, isang button na "Add more" na nagdadagdag ng susunod na mga mensahe (teksto, larawan, file) sa submission sa loob ng sampung minuto, at ang link sa sariling status page ng tao.
  • Paglalathala: isinusulat ng app2email ang WhatsApp form para sa inyo, hinahati ang mahabang hakbang sa ilang screen kapag hinihingi ito ng mga limitasyon ng WhatsApp, at itinatabi ang huling limang nailathalang bersyon para ang mas lumang mensaheng naipadala ay magbukas pa rin ng form na ipinadala rito.

Ang web page. Ang parehong mga hakbang sa /form/your-code/form-key. Hinihingi nito ang pangalan at numero ng WhatsApp sa huli. Pagkatapos magpadala, makikita ng tao ang reference at maaaring mag-tap ng "Get updates on WhatsApp", na nagkukumpirma ng numero nila sa pamamagitan ng isang mensahe; maaaring itakda ang form na hingin ito. Ang personal na link (ipinadala ninyo) ay alam na kung sino ang tao. Para ilagay ang form sa sarili ninyong site, gamitin ang snippet sa ilalim ng Share; kung humihingi ang form ng lokasyon, idagdag ang allow="geolocation" sa iframe. Pinaliliit ang mga larawan sa browser bago i-upload; hanggang 10 MB ang laki ng file.

Paano nakakarating ang mga tao sa form

  • Isang salita: bawat form ay may sariling mga salita. Ang mga salitang form, forms, report at submit (maaari ninyong baguhin) ay naglilista ng mga form ninyo bilang menu kapag marami ang mga ito. Binibilang lang ang salita sa maikling mensahe: isang may mas kaunti sa 10 ibang salita (Settings, "Ignore the words in long messages"), kaya ang mahabang mensaheng nagkataong naglalaman nito ay hindi magsisimula ng anuman.
  • Isang link o QR code: link na nagbubukas ng chat ninyo sa WhatsApp na may salita ng form, o ang address ng web page.
  • Ipinadala ninyo: ang "Send form" sa inbox, o ang API, ay nagpapadala ng form sa isang numero, na may mga halagang nakapuno na (numero ng trabaho, account, mga dokumentong gusto ninyo).
  • Susunod na tanong: ang isang automation o miyembro ng team ay humihingi ng higit pa sa pamamagitan ng pangalawang form. Ang ibinalik nito ay ikinakabit sa unang submission.
  • Ang web page, at ang API para sa mga sistemang may hawak na na ng datos.

Sino ang maaaring magpadala. Sinuman (ang karaniwang pinipili), o ang mga numerong inilista ninyo o mga contact na may tag ninyo lamang. Sa ganitong paraan nananatili ang form sa field staff ninyo. Ang salitang status ay sumasagot sa tao ng yugto ng kanilang mga kamakailang submission.

Mga yugto

Ang mga yugto ay pag-aari ng form. Ang bagong form ay nagsisimula sa New, In progress at Done; palitan ang pangalan nila, magdagdag ng sarili ninyo (2 hanggang 12), at pumili ng kulay. Bawat yugto ay isa sa tatlong uri: open, done o cancelled.

  • Sino ang maaaring pumili nito: itago ang isang yugto para sa ilang tungkulin. Naghahanda ang Agent, tanging Manager ang nag-aaprubar.
  • Kinakailangan ang note: humingi ng dahilan kapag inilipat dito ang isang submission (tinanggihan, ibinalik, tinanong).
  • Mensahe: isang tekstong ipinapadala sa tao kapag dumating ang submission nila sa yugto, may mga placeholder.
  • Mga button para sa tao: ang isang reply ay maaaring magdala ng hanggang tatlong button (Accept, Decline, "Not fixed yet"), at bawat isa ay naglilipat ng yugto. Ang iisang bagay na ito ay nagbibigay sa inyo ng pagtanggap ng quote, pagkumpirma ng pagbisita, at "naayos na ba?".

Ang reply na isinulat sa labas ng oras ng sagot ng WhatsApp ay itinatabi at ihahatid kapag muling sumulat ang tao. Sinasabi ito ng inbox sa reply.

Ang inbox at mga tungkulin

Ipinapakita ng Inbox ang Open, Mine, Unassigned, Done at All, kasama ang mga view na sine-save ninyo. Maghanap at mag-filter ayon sa form, yugto, assignee, tag, channel at petsa. Tatlong layout: listahan, table (isang form: bawat tanong ay isang hanay), at board (isang form: isang hanay para sa bawat yugto). Lagyan ng tsek ang ilang hilera para sabay-sabay baguhin ang yugto, italaga, lagyan ng tag, i-export o burahin ang mga ito.

Ang submission ay nagpapakita ng mga sagot nito, mga file nito, kung saan ito ipinadala, at isang kasaysayan ng lahat ng nangyari dito: mga pagbabago ng yugto kasama kung sino at bakit, mga note, mga reply sa magkabilang direksyon, mga file, at bawat hakbang ng automation kasama ang resulta nito. Sa ibaba, sumusulat kayo ng internal na note o ng reply sa WhatsApp. Maaaring i-export ang anumang view bilang CSV, Excel o JSON, at ang isang submission bilang PDF.

Ang inyong team. Mag-imbita ng mga tao sa pamamagitan ng e-mail sa inbox lamang. Makakakuha sila ng magaan na app na sarili nila sa /desk at hindi nila makikita ang iba pa ng account ninyo. Ang tungkulin ay panimulang hanay ng mga kakayahan, at bawat kakayahan ay maaaring i-on o i-off para sa isang tao.

TungkulinNagsisimula sa
Owner, AdminLahat, kasama ang mga form, automation, koneksyon at team
ManagerMga note, reply, pag-edit ng sagot, pagpapalit ng yugto, pag-assign, mga file, pag-export, pagburá, at pagpapatakbo ng mga manual na aksyon
AgentMga note, reply, pag-edit ng sagot, pagpapalit ng yugto, mga file, at pagpapatakbo ng mga manual na aksyon. Maaaring kunin ng agent ang isang submission para sa sarili
ViewerMakakabasa, wala nang iba

Maaari ninyo ring paliitin kung ano ang nakikita ng isang tao: ilang form lamang, tanging ang naka-assign sa kanila (kasama o walang mga walang assignee na mapupulot nila), at nakatagong detalye ng contact. Bawat aksyon ng miyembro ng team ay naitatala sa kasaysayan ng submission.

Ang sariling pahina ng tao. Bawat submission ay may pribadong pahina sa /s/a-long-code, nang walang login: ang yugto, ang mga mensahe at pagbabago ng yugto hanggang ngayon, ang bukas ninyong tanong kasama ang mga button nito, at "Add information" kapag pinapayagan ito ng form. Hindi kailanman lumalabas doon ang mga internal na note at internal na field.

Privacy. Ang pagburá ng contact ay bumubura rin ng kanilang mga submission at file. Maaaring magkaroon ng keep-for na oras ang form, pagkatapos nito ay binubura ang mga sarado nang submission.

Mga automation

Ang automation ay binabasa bilang isang pangungusap: kapag may nangyari, kung totoo ang ilang bagay, gawin ang mga ito nang sunud-sunod. "Kapag isinumite ang Quote request, kung ang quantity ay 20 o higit pa, italaga ito sa mga Manager at i-e-mail ang owner."

KapagTumatakbo kapag
submittedkumpleto na ang submission at dumating na ang mga file nito
status_changednagbago ang yugto (opsyonal: patungo o mula sa ilang yugto)
assignednagbago ang taong naka-assign dito
updatedna-edit ang mga sagot o internal na field
note_addedmay sinulat na note ang miyembro ng team
file_addedmay idinagdag na file pagkatapos
customer_repliednagdagdag ng teksto o file ang taong nagpadala
buttonpinindot ng tao ang button ng isa sa mga reply ninyo
overduenasa parehong yugto pa rin ito pagkatapos ng ilang minuto
duelumipas na ang takdang oras nito habang bukas ito
manualpinipindot ng miyembro ng team ang button ng aksyon sa submission

Kung: mga tuntunin sa mga sagot, mga kinakalkula na halaga, ang yugto, ang channel, mga tag at ang assignee. Ang tuntunin ay isang field, isang operator at isang halaga: equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte. Pagsamahin ang mga tuntunin gamit ang all (at) o any (o).

GawinAno ang ginagawa nito
set_statusilipat sa isang yugto, may note
assignsa isang miyembro, salitan sa isang tungkulin, sa pinakahindi-abalang miyembro ng tungkulin, o sa wala
set_field, calculatesumulat ng internal na field, o kalkulahin ito gamit ang pormula
tag, set_priority, set_duemga tag, prayoridad, takdang oras
replymensaheng WhatsApp sa tao, may hanggang 3 button na bawat isa ay naglilipat ng yugto, isang file, o ang link sa kanilang status page
ask_locationhingin sa tao na ibahagi kung nasaan sila
send_formmagpadala ng follow-up na form; ang ibinalik nito ay ikinakabit sa submission na ito
emailsa owner, sa assignee, sa tao, o sa anumang address, kasama ang mga naka-attach na file
notifye-mail sa assignee, sa isang tungkulin, o sa lahat sa team
http, openapi, mcptumawag sa isang koneksyon at itago ang ilang bahagi ng sagot sa mga field
waitmagpatuloy mamaya, kung totoo pa rin ang mga kondisyon
stoptapusin dito

Bawat takbo ay naitatala hakbang-hakbang: ano ang ipinadala, ano ang bumalik, at gaano katagal ito inabot. Ang "Try with a submission" ay nagpapatakbo ng automation laban sa totoong submission nang hindi binabago o ipinapadala ang anuman. Ang tawag sa labas na sistemang pumalya ay susubukan ulit pagkatapos ng 1 minuto, 10 minuto at 1 oras; pagkatapos nito, mamarkahang pumalya ang automation at makakatanggap ang mga webhook ninyo ng submit.automation_failed. Ang mga automation na nagpapagana sa isa't isa ay pinapahinto pagkatapos ng tatlong antas.

Recipe 1: ang malalaking quote ay napupunta sa 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
    }
  ]
}

Recipe 2: ipadala ang quote, humingi ng sagot, at magpaalala pagkatapos ng tatlong araw

Ang quote_amount ay isang internal na field na pinupuno ng team ninyo bago ilipat ang submission sa Quoted. Lalabas lamang ang paalala kung nasa Quoted pa rin ang submission.

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

Recipe 3: itabi ang pagbabasa ng metro na mukhang mali

Ang usage ay kinakalkulang halaga: 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."
    }
  ]
}

Mga koneksyon

Ang koneksyon ay isang panlabas na sistemang maaaring tawagan ng automation. Hindi nangangailangan ng anuman ang mga webhook ng account ninyo: tumatanggap sila ng bawat event ng submission habang nangyayari ito (tingnan ang mga event). Para sa lahat ng iba pa, may tatlong uri. Ang "Test" sa isang koneksyon, at ang "Try with a submission" sa isang aksyon, ay nagpapakita ng totoong request at totoong sagot bago may anumang i-on.

HTTP request

Isang base address at isang paraan ng pag-sign in (wala, isang bearer token, isang header, user name at password, o isang key sa address). Sinasabi ng aksyon ang method, ang path, at isang JSON body. Itinatago ng save ang ilang bahagi ng sagot sa mga field ng submission.

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

OpenAPI document

Ibigay ang address ng isang OpenAPI 3 document sa JSON, o i-paste ito. Binabasa ng app2email ang mga operation nito; pinipili ng aksyon ang isa ayon sa id nito at pinupuno ang mga parameter nito. Hindi binabasa ang YAML at Swagger 2 na document.

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

Ibigay ang address ng isang MCP server (streamable HTTP) at ang token nito. Inililista ng app2email ang mga tool ng server; pinipili ng aksyon ang isa at pinupuno ang mga argumento nito. Itinatago ng $text ang buong sagot ng tool bilang teksto.

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

Magandang malaman. Ang halagang eksaktong isang placeholder ay pinananatili ang uri nito (ang numero ay nananatiling numero, ang listahan ay nananatiling listahan). Ang mga secret ay naka-imbak nang naka-encrypt, hindi na muling ipinapakita at hindi kailanman ibinabalik ng API. Dapat https at pampubliko ang mga address: tinatanggihan ang pribado, lokal at panloob na address, at hindi sinusundan ang mga redirect. Maaaring tumagal ng 15 segundo ang isang tawag at 256 KB ang laki ng sagot nito. Sa save, ang path ay $ (ang buong sagot) o isang simpleng path gaya ng $.data.items[0].id.

Mga placeholder

Bawat teksto at bawat parameter ng isang aksyon ay maaaring gumamit ng mga placeholder sa mga kulot na bracket. Ang pangalang hindi kilala ay mananatili gaya ng pagkakasulat ninyo rito.

PlaceholderNagiging
{<field key>}ang sagot sa tanong na iyon (pati internal na field, kinalkulang halaga at mga halagang na-save ng automation)
{reference}ang reference, halimbawa MR-7Q3M2A
{form} {form_key}ang pangalan ng form at ang key nito
{status} {status_name}ang key at pangalan ng yugto
{channel}whatsapp, web, api o staff
{priority} {tags}ang prayoridad at mga tag
{created} {updated} {due}ang mga oras
{contact.name} {contact.phone} {contact.email}ang taong nagpadala
{assignee.name} {assignee.email}ang miyembro ng team na naka-assign dito
{link}ang sariling status page ng tao
{desk_link}ang submission sa inbox ng team ninyo
{answers}lahat ng sagot bilang mga linyang "Label: halaga"
{files} {files.<field key>}mga link sa lahat ng file, o sa mga file ng isang tanong; maaaring kunin ng ibang sistema ang mga ito sa loob ng 7 araw
{note}ang note ng pagbabago ng yugto, o ang note na nagpasimula sa automation
{button}ang button na pinindot ng tao
{business}ang pangalan ng negosyo ninyo
{submission}sa JSON body: ang buong submission bilang isang object
{= formula }isang pormulang kinakalkula sa lugar, halimbawa {= round(qty * 1.1, 2) }

Mga pormula

Ginagamit ng mga kinakalkulang halaga, ng aksyong calculate, at sa loob ng {= ... } sa anumang teksto. Gumagana ang pormula sa mga numero, mga teksto sa single quote, at mga key ng inyong mga tanong. Maaari itong hanggang 500 karakter ang haba. Ang paghahati sa zero, o numerong nawawala, ay nagbibigay ng walang laman na halaga sa halip na error.

Isusulat ninyoKahulugan
+ - * / %aritmetika sa mga numero at sagot
== != > >= < <=paghahambing
and or not ( )lohika at mga bracket
if(condition, a, b)a kapag totoo ang kondisyon, kung hindi ay b
min(a, b, ...) max(a, b, ...)ang pinakamaliit, ang pinakamalaki
round(x, n) abs(x)pagbilog sa n decimal, ang laki ng numero nang walang sign
num(x) len(x)isang teksto bilang numero; ang haba ng teksto o listahan
coalesce(a, b)a, o b kapag walang laman ang a
lower(x) upper(x) concat(a, b, ...)mga teksto
lookup('list', id, 'column')isang hanay ng isang hilera ng isa sa inyong listahan, halimbawa isang presyo
previous('field')ang huling sagot ng parehong tao sa tanong na iyon
count_files('field')ilang file ang hawak ng isang tanong
days_since(date)ilang araw mula sa isang petsa hanggang ngayon

Mga halimbawa: qty * lookup('prices', product, 'price') para sa agarang tantiya; reading - previous('reading') para sa paggamit; if(amount > 500, 'manager', 'agent') para magpasya kung sino ang mag-aaprubar.

Para sa mga developer at AI agent

Ang lahat ng nasa itaas ay nasa REST API sa ilalim ng /v1/{number}/submit, kung saan ang {number} ay ang numero ninyo sa WhatsApp na may country code, mga digit lang. Ipadala ang API key ninyo bilang Authorization: Bearer YOUR_API_KEY (tinatanggap din ang header na X-API-KEY). Kailangan ng key ang scope na submissions:manage; mayroon nito ang mga key na may full access, wala ang Default key. Hindi makakasulat ang sandbox key.

  1. GET /submit/guide: isang JSON document na may buong bokabularyo: mga uri ng tanong kasama ang mga pagpipilian at limitasyon nito, mga tuntunin ng yugto, mga trigger, operator, aksyon kasama ang mga parameter nito, mga placeholder, mga function ng pormula, ang mga template, at mga halimbawang gawa.
  2. POST /submit/setup na may "dry_run": true: walang nasusulat; ibinabalik ang bawat problema kasama ang path nito at isang pangungusap kung paano ito ayusin.
  3. POST /submit/setup nang walang dry_run: ang mga listahan, koneksyon, form at automation ay sabay-sabay na inilalapat. Kapag may anumang problema, walang nasusulat.
  4. POST /submit/forms/{key}/publish, o pangalanan ang mga form sa "publish" ng setup document.
  5. Ibahagi ang mga link ng form (ibinabalik ng GET /submit/forms/{key} ang mga ito), saka basahin ang GET /submit/submissions o makinig sa mga webhook event.

Isang buong tawag sa setup

I-save ang dokumentong nasa ibaba bilang setup.json at i-post ito. Palitan ang 61400000000 ng numero ninyo. Sinusuri nito ang isang solusyon para sa pagbabasa ng metro: isang listahan ng mga site, isang koneksyon sa billing system, isang form na may tatlong yugto at kinalkulang usage, at dalawang automation. Alisin ang "dry_run": true para ilapat ito. Ang mga umiiral na form, listahan at koneksyon na may parehong key ay papalitan; ang mga automation ay itinutugma ayon sa pangalan sa loob ng form. Ang "preset": "..." sa halip na mga bahagi ay nag-i-install ng isa sa mga template (inililista ng GET /submit/presets ang mga ito).

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

Ang sagot ng totoong tawag (nang walang 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": []
}

Ang iba pang route

  • Settings: GET / PUT /submit/settings.
  • Mga form: ilista, gumawa (mula sa isang definition o template), basahin, i-update, burahin, ilathala, at POST /submit/forms/{key}/send para magpadala ng form sa isang numero na may nakapunang mga halaga.
  • Mga listahan: pinapalitan ng PUT /submit/lists/{key} ang mga hilera ng isang listahan.
  • Mga submission: ilista (i-filter ayon sa form, yugto, assignee, tag, channel, contact, teksto at mga petsa; updated_after para sa pag-sync; CSV gamit ang ?format=csv), gumawa, basahin ayon sa id o reference, i-update (yugto, note, prayoridad, assignee, takdang oras, mga tag, sagot, internal na field), magdagdag ng note, mag-reply na may mga button, magdagdag ng file, magburá.
  • Mga automation at takbo: ilista, gumawa, basahin, i-update, burahin, POST /submit/automations/try, at ang log ng takbo.
  • Mga koneksyon: ilista, itakda, burahin, subukan, i-refresh, at ang mga function na maaaring tawagan ng isang aksyon.
  • Team at report: mag-imbita, mag-update at mag-alis ng mga miyembro; bilang ayon sa form, yugto, araw at assignee.

Mga webhook event

Bawat webhook ng account ninyo ay tumatanggap ng bawat event. Bawat isa ay may dalang submission gaya ng pagkakaroon nito sa sandaling iyon; gumagana ang mga link ng file dito sa loob ng 7 araw.

EventKailan
submission.createdmay submission na (maaaring dumarating pa ang mga file nito)
submission.files_readynaitabi na ang mga file nito
submission.updatednagbago ang mga sagot, internal na halaga, prayoridad, tag o takdang oras
submission.status_changednagbago ang yugto
submission.assignednagbago ang assignee
submission.note_addedmay sinulat na note
submission.customer_repliednagdagdag ang tao ng teksto, file o follow-up, o pinindot ang button
submission.deletednabura o nabura nang tuluyan
submit.automation_failedsumuko ang isang automation pagkatapos ng mga pag-ulit nito

Mga MCP tool

Ang bawat route ay isa ring tool sa hosted MCP server ng app2email, kaya kayang gawin ng isang assistant ang buong setup sa isang usapan: 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 at marami pang iba. Magandang unang mensahe sa assistant: "Basahin ang gabay ng Submit-Info, saka mag-set up ng form ng ulat ng problema na may mga larawan at lokasyon, at sabihan ang mga manager ko tungkol sa mga agarang problema."

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

Higit pa sa pagkonekta ng mga assistant at mga tool ng automation: Mga tool at agent ng automation.

Mga limitasyon

LimitasyonHalaga
Mga form bawat numero100
Mga hakbang sa isang form, mga tanong sa isang hakbang12 at 12 (60 tanong sa isang form, isang tanong sa lokasyon)
Mga listahan50, hanggang 1,000 hilera bawat isa
Mga automation, koneksyon, miyembro ng team200, 30, 200
Mga file sa isang submission60
Laki ng file25 MB mula sa WhatsApp, 10 MB mula sa web page o API
Isang note o reply4,000 karakter
Mga tag sa isang submission20
Mga tawag sa mga sistemang panlabas60 kada minuto at 2,000 kada araw bawat numero; 15 segundo at 256 KB bawat tawag
Log ng takbo30 araw na itinatago

Hindi pa available

  • Pagtanggap ng bayad sa isang submission (tinatanggap ang quote, hindi binabayaran).
  • Pagpapadala ng form sa taong hindi pa sumusulat sa inyo sa nakaraang 24 oras bilang form sa WhatsApp: ang personal na web link nila ang makukuha ninyo, para ipadala sa anumang aprubadong template.
  • Mga lagda.
  • Mga paulit-ulit na grupo ("add another item").
  • Paglukso sa ibang form sa kalagitnaan.
  • Pagpuno ng form nang walang koneksyon.
  • Ibang wika sa mga nakapirmihang teksto ng web page (bawat teksto ng inyong form ay inyong isusulat).
  • Mga OpenAPI document sa YAML o Swagger 2, at mga MCP server na tanging ang mas lumang SSE transport ang nakakausap.
  • Pagbasa ng mga halaga mula sa larawan.

Ang lahat ng nasa itaas ay itinatakda sa dashboard page ng Submit-Info (/dashboard/app/submit). Mga tanong: support@app2email.com.