Ìtọ́sọ́nà sí Submit-Info: kọ́ fọ́ọ̀mù láti inú àtòjọ ìbéèrè, tẹ̀ ẹ́ jáde sí WhatsApp àti ojú-ìwé wẹ́ẹ̀bù, máa ṣiṣẹ́ àwọn ìfisílẹ̀ nípasẹ̀ àwọn ìpele nínú àpótí ìwọlé tí a pín pẹ̀lú àwọn ipa, ṣe automation fún àwọn ìdáhùn àti ìpè sí àwọn ètò yín, kí ẹ sì ṣètò ohun gbogbo nípasẹ̀ API tàbí agent AI.
Ẹ kọ fọ́ọ̀mù gẹ́gẹ́ bí àtòjọ ìbéèrè tí ó rọrùn. app2email ń yí i padà sí fọ́ọ̀mù nínú WhatsApp àti sí ojú-ìwé wẹ́ẹ̀bù pẹ̀lú àwọn ìgbésẹ̀ kan náà. Oníbàárà, tàbí ọmọ ẹgbẹ́ òṣìṣẹ́ pápá yín, yóò kún un, yóò sì gba nọ́mbà ìtọ́kasí. Àwọn ìdáhùn àti faili yóò di ìfisílẹ̀ nínú àpótí ìwọlé tí a pín, níbi tí ó ti ń lọ láti ìpele kan sí òmíràn tí ó sì ń mú àwọn automation yín ṣiṣẹ́.
Ìmọ̀ kan
Fọ́ọ̀mù, lẹ́yìn náà ìfisílẹ̀, lẹ́yìn náà àwọn ìpele, lẹ́yìn náà àwọn automation, lẹ́yìn náà àwọn ìsopọ̀. Ìbéèrè iye owó, ìfẹ̀hónúhàn, kíka mítà, ìròyìn ìṣòro, iṣẹ́ tí a parí, ẹ̀rí ìfijiṣẹ́ àti ìwé ìnáwó jẹ́ ohun kan náà pẹ̀lú àwọn ìbéèrè àti orúkọ ìpele tí ó yàtọ̀. Ọ̀kọ̀ọ̀kan wá gẹ́gẹ́ bí àwòṣe tí ẹ lè fi sori ẹ̀rọ, tí ẹ sì lè yí padà.
Kò sí nǹkan tí yóò yípadà fún nọ́mbà tí kò ṣí Submit-Info rí. Fọ́ọ̀mù tí a kò tíì tẹ̀ jáde sí WhatsApp síbẹ̀ ṣì ń ṣiṣẹ́: ọ̀rọ̀ rẹ̀ yóò dá ènìyàn lóhùn pẹ̀lú ìjápọ̀ sí ojú-ìwé wẹ́ẹ̀bù.
Fọ́ọ̀mù kan ní ìgbésẹ̀ 1 sí 12, ìgbésẹ̀ kọ̀ọ̀kan sì ní àkọlé àti ìbéèrè 1 sí 12. Kò sí canvas, kò sì sí ohun láti yà: àtòjọ kan náà ni ó ń darí fọ́ọ̀mù lórí WhatsApp, ojú-ìwé wẹ́ẹ̀bù, àyẹ̀wò àwọn ìdáhùn, àwọn ọ̀wọ̀n ìwòran tábìlì, ìkójáde àti API. Àwòkọ́ṣe tí ó wà lẹ́gbẹ̀ẹ́ olùṣàtúnṣe fi bí ènìyàn ṣe ń rí fọ́ọ̀mù náà hàn.
| Irú | Ohun tí ènìyàn fúnni | Ohun tí ẹ lè ṣètò |
|---|---|---|
text | Ìdáhùn kúkúrú | gígùn tó kéré jùlọ àti tó tóbi jùlọ, àpẹẹrẹ |
textarea | Ìdáhùn gígùn | gígùn tó kéré jùlọ àti tó tóbi jùlọ |
number | Nọ́mbà | iye tó kéré jùlọ àti tó tóbi jùlọ, àwọn ìpín desimali, ẹyọ bíi kWh |
email | Àdírẹ́sì imeeli | |
phone | Nọ́mbà fóònù | |
date | Ọjọ́ kan | iye ọjọ́ tí ó lè wà sẹ́yìn tàbí ní iwájú |
select | Àṣàyàn kan | àwọn àṣàyàn (2 sí 200), tàbí àtòjọ tiyín |
multiselect | Ọ̀pọ̀ àṣàyàn | àwọn àṣàyàn (2 sí 20), iye tó kéré jùlọ àti tó pọ̀ jùlọ láti yan |
yesno | Bẹ́ẹ̀ ni tàbí Bẹ́ẹ̀ kọ́ | |
rating | Àmì láti 1 dé 3-10 | àmì tó ga jùlọ |
consent | Gbólóhùn láti gbà | bóyá ó gbọ́dọ̀ jẹ́ àmì sí |
photo | Fọ́tò kan tàbí ju bẹ́ẹ̀ lọ | iye (1 sí 10); kámẹ́rà, gálárì tàbí méjèèjì |
document | Faili kan tàbí ju bẹ́ẹ̀ lọ | iye (1 sí 10); faili èyíkéyìí, PDF, àwòrán tàbí faili ọ́fíìsì |
location | Ibi tí ènìyàn wà | lórí WhatsApp, ìbéèrè ipò; lórí wẹ́ẹ̀bù, bọ́tìnnì àti ìlà àdírẹ́sì |
info | Ọ̀rọ̀ tí ẹ fihàn | a kò béèrè tàbí tọ́jú nǹkankan |
hidden | Iye tí ó wá pẹ̀lú ìjápọ̀ | bíi nọ́mbà iṣẹ́; a kò fi nǹkankan hàn |
{contact.name}.Ojú-ìwé wẹ́ẹ̀bù. Àwọn ìgbésẹ̀ kan náà wà ní /form/your-code/form-key. Ó ń béèrè orúkọ àti nọ́mbà WhatsApp kẹ́yìn. Lẹ́yìn fífi ránṣẹ́, ènìyàn náà rí nọ́mbà ìtọ́kasí, ó sì lè tẹ "Get updates on WhatsApp", tí ó fọwọ́sí nọ́mbà rẹ̀ pẹ̀lú ìfiránṣẹ́ kan; a lè ṣètò fọ́ọ̀mù láti béèrè èyí. Ọ̀nà ìsopọ̀ ti ara ẹni (tí ẹ fi ránṣẹ́) ti mọ ẹni tí ènìyàn náà jẹ́ tẹ́lẹ̀. Láti fi fọ́ọ̀mù náà sí ojú-ìwé tiyín, lo kóòdù tí ó wà lábẹ́ Share; tí fọ́ọ̀mù bá béèrè ibi, fi allow="geolocation" kún iframe. Àwọn fọ́tò ni a ń dín kéré nínú ẹ̀rọ aṣàwákiri kí a tó gbé wọn sókè; faili kan lè tóbi tó 10 MB.
Ẹni tí ó lè fi ránṣẹ́. Ẹnikẹ́ni (àṣàyàn tí ó wọ́pọ̀ jùlọ), tàbí àwọn nọ́mbà tí ẹ tò nìkan tàbí àwọn olùbásọ̀rọ̀ pẹ̀lú àmì tiyín. Bẹ́ẹ̀ ni fọ́ọ̀mù ṣe máa ń wà pẹ̀lú òṣìṣẹ́ pápá yín. Ọ̀rọ̀ status ń dá ènìyàn lóhùn pẹ̀lú ìpele àwọn ìfisílẹ̀ rẹ̀ tó ṣẹ̀ṣẹ̀ wà.
Àwọn ìpele jẹ́ ti fọ́ọ̀mù náà. Fọ́ọ̀mù tuntun bẹ̀rẹ̀ pẹ̀lú New, In progress àti Done; ẹ lè tún wọn dárúkọ, ẹ lè fi tiyín kún (2 sí 12), kí ẹ sì yan àwọ̀. Ìpele kọ̀ọ̀kan jẹ́ ọ̀kan nínú irú mẹ́ta: ṣí, parí tàbí fagilee.
Ìdáhùn tí a kọ ní ìta àkókò ìdáhùn WhatsApp ni a ó pamọ́, a ó sì fi jíṣẹ́ nígbà tí ènìyàn bá kọ̀wé ní àkókò tó ń bọ̀. Inbox yóò sọ èyí lórí ìdáhùn náà.
Inbox fihàn Open, Mine, Unassigned, Done àti All, pẹ̀lú àwọn ìwòran tí ẹ fi pamọ́. Wá àti ṣàlẹ̀mọ́ nípasẹ̀ fọ́ọ̀mù, ìpele, ẹni tí a yàn sí, àmì, ikanni àti ọjọ́. Ìṣètò mẹ́ta wà: àtòjọ, tábìlì (fọ́ọ̀mù kan: ìbéèrè kọ̀ọ̀kan jẹ́ ọ̀wọ̀n kan) àti pátákó (fọ́ọ̀mù kan: ọ̀wọ̀n kan fún ìpele kọ̀ọ̀kan). Ẹ yan ọ̀pọ̀ ìlà láti yí ìpele padà, yàn, fi àmì sí, kó jáde tàbí pa wọn pọ̀.
Ìfisílẹ̀ kọ̀ọ̀kan ń fihàn àwọn ìdáhùn rẹ̀, àwọn faili rẹ̀, ibi tí a ti fi ránṣẹ́, àti ìtàn kan ṣoṣo ti gbogbo ohun tí ó ṣẹlẹ̀ sí i: àwọn àyípadà ìpele pẹ̀lú ẹni àti ìdí, àwọn àkọsílẹ̀, ìdáhùn ní ọ̀nà méjèèjì, àwọn faili, àti ìgbésẹ̀ automation kọ̀ọ̀kan pẹ̀lú àbájáde rẹ̀. Ní ìsàlẹ̀ ni ẹ ti ń kọ àkọsílẹ̀ inú tàbí ìdáhùn WhatsApp. Ẹ lè kó ìwòran èyíkéyìí jáde gẹ́gẹ́ bí CSV, Excel tàbí JSON, àti ìfisílẹ̀ kan gẹ́gẹ́ bí PDF.
Ẹgbẹ́ yín. Ẹ pe àwọn ènìyàn pẹ̀lú imeeli sí inbox nìkan. Wọ́n gba ohun elo fúyẹ́ tiwọn ní /desk, wọn kì í sì í rí iyókù àkáántì yín. Ipa jẹ́ àkójọpọ̀ agbára tí ó bẹ̀rẹ̀, agbára kọ̀ọ̀kan sì lè wà tàbí kí ó jáde fún ènìyàn kan.
| Ipa | Bẹ̀rẹ̀ pẹ̀lú |
|---|---|
| Owner, Admin | Ohun gbogbo, pẹ̀lú fọ́ọ̀mù, automation, ìsopọ̀ àti ẹgbẹ́ |
| Manager | Àwọn àkọsílẹ̀, ìdáhùn, ṣíṣàtúnṣe ìdáhùn, yíyí ìpele padà, yíyàn, faili, kíkó jáde, píparẹ́, ṣíṣe àwọn ìgbésẹ̀ lọ́wọ́ |
| Agent | Àwọn àkọsílẹ̀, ìdáhùn, ṣíṣàtúnṣe ìdáhùn, yíyí ìpele padà, faili, ṣíṣe àwọn ìgbésẹ̀ lọ́wọ́. Lè gba ìfisílẹ̀ fún ara rẹ̀ |
| Viewer | Lè kà, kò sí ohun mìíràn |
Ẹ lè tún dín ohun tí ènìyàn ń rí kù: àwọn fọ́ọ̀mù kan nìkan, ohun tí a yàn sí wọn nìkan (pẹ̀lú tàbí láìsí àwọn tí kò ní ẹni tí a yàn sí láti gbà), àti ìwífún olùbásọ̀rọ̀ tí a fi pamọ́. Gbogbo ìṣe ọmọ ẹgbẹ́ kan ni a kọ sínú ìtàn ìfisílẹ̀ náà.
Ojú-ìwé ènìyàn náà. Ìfisílẹ̀ kọ̀ọ̀kan ní ojú-ìwé aládàáni ní /s/a-long-code, láìní wíwọlé: ìpele, àwọn ìfiránṣẹ́ àti àyípadà ìpele títí di báyìí, ìbéèrè ṣíṣí yín pẹ̀lú àwọn bọ́tìnnì rẹ̀, àti "Add information" nígbà tí fọ́ọ̀mù bá gbà. Àwọn àkọsílẹ̀ inú àti àwọn pápá inú kì í wà lórí rẹ̀ láé.
Àṣírí. Píparẹ́ olùbásọ̀rọ̀ kan ń pa àwọn ìfisílẹ̀ àti faili rẹ̀ rẹ́. Fọ́ọ̀mù lè ní àkókò ìpamọ́, lẹ́yìn èyí tí a ó pa àwọn ìfisílẹ̀ tí a ti parí rẹ́.
Automation kan kà bí gbólóhùn kan: nígbà tí nǹkan kan bá ṣẹlẹ̀, bí àwọn nǹkan kan bá jẹ́ òtítọ́, ṣe àwọn nǹkan wọ̀nyí ní ìtẹ̀lé. "Nígbà tí a bá fi Quote request ránṣẹ́, bí quantity bá jẹ́ 20 tàbí ju bẹ́ẹ̀ lọ, yàn án sí Managers, kí ẹ sì fi imeeli ránṣẹ́ sí owner."
| Nígbà | Ó ń ṣiṣẹ́ nígbà tí |
|---|---|
submitted | ìfisílẹ̀ kan bá parí, tí àwọn faili rẹ̀ sì ti dé |
status_changed | ìpele bá yípadà (bí ó bá wù yín: sí tàbí láti àwọn ìpele kan) |
assigned | ẹni tí a yàn án sí bá yípadà |
updated | a ṣàtúnṣe àwọn ìdáhùn tàbí pápá inú |
note_added | ọmọ ẹgbẹ́ kan kọ àkọsílẹ̀ kan |
file_added | a fi faili kún nígbà tí ó yá |
customer_replied | ènìyàn tí ó fi ránṣẹ́ fi ọ̀rọ̀ tàbí faili kún |
button | ènìyàn tẹ bọ́tìnnì kan lára ìdáhùn kan tiyín |
overdue | ó wà ní ìpele kan náà lẹ́yìn iye ìṣẹ́jú kan |
due | àkókò rẹ̀ kọjá nígbà tí ó ṣì ṣí |
manual | ọmọ ẹgbẹ́ kan tẹ bọ́tìnnì ìgbésẹ̀ náà lórí ìfisílẹ̀ náà |
Bí: òfin lórí àwọn ìdáhùn, àwọn iye tí a ṣírò, ìpele, ikanni, àwọn àmì àti ẹni tí a yàn sí. Òfin kan jẹ́ pápá, oníṣẹ́ kan àti iye kan: equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte. So àwọn òfin pọ̀ pẹ̀lú all (àti) tàbí any (tàbí).
| Ṣe | Ohun tí ó ń ṣe |
|---|---|
set_status | yí padà sí ìpele kan, pẹ̀lú àkọsílẹ̀ kan |
assign | sí ọmọ ẹgbẹ́ kan, lẹ́ẹ̀kọ̀ọ̀kan nípasẹ̀ ipa kan, sí ẹni tí iṣẹ́ rẹ̀ kéré jùlọ nínú ipa kan, tàbí sí ẹnikẹ́ni |
set_field, calculate | kọ pápá inú kan, tàbí ṣírò rẹ̀ pẹ̀lú agbekalẹ̀ |
tag, set_priority, set_due | àwọn àmì, pàtàkì, àkókò tí ó yẹ kí ó parí |
reply | ìfiránṣẹ́ WhatsApp sí ènìyàn, pẹ̀lú títí dé 3 bọ́tìnnì tí ọ̀kọ̀ọ̀kan ń sí ìpele padà, faili kan, tàbí ìjápọ̀ sí ojú-ìwé ipò wọn |
ask_location | béèrè lọ́wọ́ ènìyàn láti pín ibi tí ó wà |
send_form | fi fọ́ọ̀mù ìtẹ̀lé ránṣẹ́; ohun tí ó bá padà wá ni a so mọ́ ìfisílẹ̀ yìí |
email | sí owner, ẹni tí a yàn sí, ènìyàn, tàbí àdírẹ́sì èyíkéyìí, pẹ̀lú àwọn faili tí a so mọ́ |
notify | imeeli sí ẹni tí a yàn sí, ipa kan, tàbí gbogbo ẹgbẹ́ náà |
http, openapi, mcp | pe ìsopọ̀ kan, kí ẹ sì pa àwọn apá ìdáhùn mọ́ sí àwọn pápá |
wait | tẹ̀síwájú lẹ́yìn náà, nìkan bí àwọn ìpò bá ṣì wà |
stop | parí níbí |
Gbogbo ìṣiṣẹ́ ni a kọ sílẹ̀ ní ìgbésẹ̀ kọ̀ọ̀kan: ohun tí a fi ránṣẹ́, ohun tí ó padà wá, àti bí ó ti pẹ́ tó. "Try with a submission" ń ṣiṣẹ́ automation lórí ìfisílẹ̀ gidi kan láìyí nǹkankan padà tàbí fi ránṣẹ́. Ìpè sí ètò lóde tí ó kùnà ni a ó tún gbìyànjú lẹ́yìn ìṣẹ́jú 1, ìṣẹ́jú 10 àti wákàtí 1; lẹ́yìn náà, a ó sàmì sí automation náà gẹ́gẹ́ bí ó ti kùnà, àwọn webhook yín yóò sì gba submit.automation_failed. Àwọn automation tí ń mú ara wọn ṣiṣẹ́ ni a ó dá dúró lẹ́yìn ìpele mẹ́ta.
{
"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
}
]
}quote_amount jẹ́ pápá inú tí ẹgbẹ́ yín ń kún kí ẹ tó sí ìfisílẹ̀ náà sí Quoted. Ìránnilétí ń jáde nìkan tí ìfisílẹ̀ bá ṣì wà ní 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."
}
]
}usage jẹ́ iye tí a ṣírò: 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."
}
]
}Ìsopọ̀ jẹ́ ètò ìta tí automation lè pè. Àwọn webhook àkọọ́lẹ̀ yín kò nílò rẹ̀: wọn ń gba gbogbo ìṣẹ̀lẹ̀ ìfisílẹ̀ bí ó ti ń ṣẹlẹ̀ (wo àwọn ìṣẹ̀lẹ̀). Fún gbogbo ohun mìíràn, irú mẹ́ta wà. "Test" lórí ìsopọ̀, àti "Try with a submission" lórí ìgbésẹ̀, ń fi ìbéèrè gidi àti ìdáhùn gidi hàn kí a tó tan ohunkóhun.
Àdírẹ́sì ìpìlẹ̀ àti ọ̀nà láti wọlé (kò sí, àmì bearer, akọlé kan, orúkọ oníṣe àti ọ̀rọ̀ aṣínà, tàbí kọ́kọ́rọ́ nínú àdírẹ́sì). Ìgbésẹ̀ náà ń dárúkọ ọ̀nà, ọ̀nà ìpa-ọ̀nà, àti ara JSON. save ń pa àwọn apá ìdáhùn mọ́ sí àwọn pápá ìfisílẹ̀.
{
"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"
}Fún àdírẹ́sì ìwé OpenAPI 3 ní JSON, tàbí lẹ̀ ẹ́ mọ́. app2email ń ka àwọn iṣẹ́ rẹ̀; ìgbésẹ̀ náà ń yan ọ̀kan nípasẹ̀ id rẹ̀, ó sì ń kún àwọn pàrámítà rẹ̀. Àwọn ìwé YAML àti Swagger 2 kì í ka.
{
"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"
}Fún àdírẹ́sì MCP server (streamable HTTP) àti àmì rẹ̀. app2email ń to irinṣẹ́ server náà; ìgbésẹ̀ náà ń yan ọ̀kan, ó sì ń kún àwọn àrọ̀ rẹ̀. $text ń pa gbogbo ìdáhùn irinṣẹ́ náà mọ́ gẹ́gẹ́ bí ọ̀rọ̀.
{
"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"
}Ó dára láti mọ̀. Iye tí ó jẹ́ ààyè àmì kan ṣoṣo ń pa irú rẹ̀ mọ́ (nọ́mbà wà nọ́mbà, àtòjọ wà àtòjọ). Àṣírí a máa fi pamọ́ ní ọ̀nà tí a fi pa mọ́, a kì í fihàn lẹ́ẹ̀kan sí i, a kì í sì í dá a padà nípasẹ̀ API. Àdírẹ́sì gbọ́dọ̀ jẹ́ https àti ti gbogbo ènìyàn: àdírẹ́sì ikọ̀kọ̀, ti agbègbè àti ti inú a kọ̀, a kò sì ní tẹ̀lé àtúndarí. Ìpè kan lè gba ìṣẹ́jú-àáyá 15, ìdáhùn rẹ̀ sì lè jẹ́ 256 KB. Nínú save, ọ̀nà jẹ́ $ (gbogbo ìdáhùn) tàbí ọ̀nà tí ó rọrùn bíi $.data.items[0].id.
Gbogbo ọ̀rọ̀ àti gbogbo pàrámítà ìgbésẹ̀ lè lo àwọn ààyè àmì nínú àmùrè kékeré. Orúkọ tí a kò mọ̀ yóò dúró bí ẹ ti kọ ọ́.
| Àmì ààyè | Di |
|---|---|
{<field key>} | ìdáhùn sí ìbéèrè náà (pẹ̀lú àwọn pápá inú, àwọn iye tí a ṣírò àti àwọn iye tí automation fi pamọ́) |
{reference} | nọ́mbà ìtọ́kasí, bíi MR-7Q3M2A |
{form} {form_key} | orúkọ fọ́ọ̀mù àti kọ́kọ́rọ́ rẹ̀ |
{status} {status_name} | kọ́kọ́rọ́ ìpele àti orúkọ rẹ̀ |
{channel} | whatsapp, web, api tàbí staff |
{priority} {tags} | pàtàkì àti àwọn àmì |
{created} {updated} {due} | àwọn àkókò |
{contact.name} {contact.phone} {contact.email} | ẹni tí ó fi ránṣẹ́ |
{assignee.name} {assignee.email} | ọmọ ẹgbẹ́ tí a yàn sí |
{link} | ojú-ìwé ipò ara ẹni ènìyàn náà |
{desk_link} | ìfisílẹ̀ náà nínú àpótí ìwọlé ẹgbẹ́ yín |
{answers} | gbogbo ìdáhùn gẹ́gẹ́ bí àwọn ìlà "Label: value" |
{files} {files.<field key>} | àwọn ìjápọ̀ sí gbogbo faili, tàbí sí àwọn faili ìbéèrè kan; ètò mìíràn lè gbà wọ́n fún ọjọ́ 7 |
{note} | àkọsílẹ̀ ìyípadà ìpele, tàbí àkọsílẹ̀ tí ó dá automation dúró |
{button} | bọ́tìnnì tí ènìyàn tẹ̀ |
{business} | orúkọ iṣòwò yín |
{submission} | nínú ara JSON: gbogbo ìfisílẹ̀ gẹ́gẹ́ bí ohun kan |
{= formula } | agbekalẹ̀ tí a ṣírò ní ibi náà, bíi {= round(qty * 1.1, 2) } |
A ń lò ó fún àwọn iye tí a ṣírò, fún ìgbésẹ̀ calculate, àti nínú {= ... } nínú ọ̀rọ̀ kankan. Agbekalẹ̀ ń ṣiṣẹ́ pẹ̀lú àwọn nọ́mbà, ọ̀rọ̀ nínú àmì ẹyọ kan àti àwọn kọ́kọ́rọ́ ìbéèrè yín. Ó lè jẹ́ ohun kikọ 500 ní gígùn. Pípín sí òdo, tàbí nọ́mbà tí kò sí, ń fún ní iye òfo dípò àṣìṣe.
| Ẹ kọ | Ìtumọ̀ |
|---|---|
+ - * / % | ìṣirò lórí àwọn nọ́mbà àti ìdáhùn |
== != > >= < <= | ìfiwéra |
and or not ( ) | ọgbọ́n, àti àmì ( ) |
if(condition, a, b) | a nígbà tí ìpò bá ṣẹ, bí kò bẹ́ẹ̀ b |
min(a, b, ...) max(a, b, ...) | èyí tí ó kéré jùlọ, èyí tí ó tóbi jùlọ |
round(x, n) abs(x) | yíká sí n desimali, iwọ̀n nọ́mbà láìsí àmì rẹ̀ |
num(x) len(x) | ọ̀rọ̀ gẹ́gẹ́ bí nọ́mbà; gígùn ọ̀rọ̀ tàbí àtòjọ |
coalesce(a, b) | a, tàbí b nígbà tí a bá ṣófo |
lower(x) upper(x) concat(a, b, ...) | ọ̀rọ̀ |
lookup('list', id, 'column') | ọ̀wọ̀n ìlà kan nínú àtòjọ tiyín, bíi iye owó |
previous('field') | ìdáhùn ìkẹyìn ènìyàn kan náà sí ìbéèrè yẹn |
count_files('field') | iye faili tí ìbéèrè kan ní |
days_since(date) | ọjọ́ láti ọjọ́ kan títí di òní |
Àpẹẹrẹ: qty * lookup('prices', product, 'price') fún ìfojúdíwọ̀n lẹsẹkẹsẹ; reading - previous('reading') fún iye lílo; if(amount > 500, 'manager', 'agent') láti pinnu ẹni tí ó fọwọ́sí.
Gbogbo nǹkan lókè wà nínú REST API lábẹ́ /v1/{number}/submit, níbi tí {number} jẹ́ nọ́mbà WhatsApp yín pẹ̀lú kóòdù orílẹ̀-èdè, àwọn nọ́mbà nìkan. Fi kọ́kọ́rọ́ API yín ránṣẹ́ gẹ́gẹ́ bí Authorization: Bearer YOUR_API_KEY (akọlé X-API-KEY náà tún ń ṣiṣẹ́). Kọ́kọ́rọ́ nílò àṣẹ submissions:manage; àwọn kọ́kọ́rọ́ tí ó ní gbogbo ìwọlé ní in, Default key kò ní in. Àwọn kọ́kọ́rọ́ sandbox kò lè kọ.
GET /submit/guide: ìwé JSON kan ṣoṣo pẹ̀lú gbogbo ọ̀rọ̀ ìṣàpèjúwe: irú ìbéèrè pẹ̀lú àwọn àṣàyàn àti ààlà wọn, òfin ìpele, àwọn ohun tí ń mú un ṣiṣẹ́, oníṣẹ́, ìgbésẹ̀ pẹ̀lú pàrámítà wọn, àwọn àmì ààyè, àwọn iṣẹ́ agbekalẹ̀, àwọn àwòṣe, àti àwọn àpẹẹrẹ tí a ṣe.POST /submit/setup pẹ̀lú "dry_run": true: kò sí nǹkan tí a kọ; gbogbo ìṣòro ni a ó dá padà pẹ̀lú ọ̀nà rẹ̀ àti gbólóhùn tí ó sọ bí a ṣe lè tún un ṣe.POST /submit/setup láìsí dry_run: àtòjọ, ìsopọ̀, fọ́ọ̀mù àti automation ni a ó lò papọ̀. Tí ìṣòro kankan bá wà, kò sí nǹkan tí a kọ.POST /submit/forms/{key}/publish, tàbí dárúkọ àwọn fọ́ọ̀mù nínú "publish" ti ìwé ìṣètò.GET /submit/forms/{key} ń dá wọn padà), lẹ́yìn náà ka GET /submit/submissions tàbí tẹ́tí sí àwọn ìṣẹ̀lẹ̀ webhook.Fi ìwé tí a fihàn nísàlẹ̀ pamọ́ bí setup.json, kí ẹ sì fi ránṣẹ́. Rọ́pò 61400000000 pẹ̀lú nọ́mbà yín. Ó ń ṣètò ojútùú kíka mítà: àtòjọ àwọn ibi, ìsopọ̀ sí ètò ìsanwó, fọ́ọ̀mù kan pẹ̀lú ìpele mẹ́ta àti lílo tí a ṣírò, àti automation méjì. Yọ "dry_run": true kúrò láti lò ó. Àwọn fọ́ọ̀mù, àtòjọ àti ìsopọ̀ tí ó ní kọ́kọ́rọ́ kan náà ni a ó rọ́pò; a ó bá automation mu nípasẹ̀ orúkọ láàrin fọ́ọ̀mù. "preset": "..." ní ipò àwọn apá ń fi ọ̀kan nínú àwọn àwòṣe sori ẹ̀rọ (GET /submit/presets ń to wọn).
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"
]
}Ìdáhùn ìpè gidi (láìsí 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": []
}GET / PUT /submit/settings.POST /submit/forms/{key}/send láti fi fọ́ọ̀mù ránṣẹ́ sí nọ́mbà kan pẹ̀lú àwọn iye tí a ti kún.PUT /submit/lists/{key} ń rọ́pò àwọn ìlà àtòjọ kan.updated_after fún ìmúṣiṣẹ́pọ̀; CSV pẹ̀lú ?format=csv), dá, kà nípasẹ̀ id tàbí ìtọ́kasí, ṣàtúnṣe (ìpele, àkọsílẹ̀, pàtàkì, ẹni tí a yàn sí, àkókò tí ó yẹ kí ó parí, àwọn àmì, ìdáhùn, pápá inú), fi àkọsílẹ̀ kún, dáhùn pẹ̀lú bọ́tìnnì, fi faili kún, pa.POST /submit/automations/try, àti ìwé ìṣiṣẹ́.Gbogbo webhook àkọọ́lẹ̀ yín ń gba gbogbo ìṣẹ̀lẹ̀. Ọ̀kọ̀ọ̀kan ní ìfisílẹ̀ gẹ́gẹ́ bí ó ṣe wà ní àkókò yẹn; àwọn ìjápọ̀ faili nínú rẹ̀ ń ṣiṣẹ́ fún ọjọ́ 7.
| Ìṣẹ̀lẹ̀ | Nígbà tí |
|---|---|
submission.created | ìfisílẹ̀ kan wà (àwọn faili rẹ̀ lè ṣì ń dé) |
submission.files_ready | a ti fi àwọn faili rẹ̀ pamọ́ |
submission.updated | àwọn ìdáhùn, iye inú, pàtàkì, àwọn àmì tàbí àkókò tí ó yẹ kí ó parí yípadà |
submission.status_changed | ìpele yípadà |
submission.assigned | ẹni tí a yàn sí yípadà |
submission.note_added | a kọ àkọsílẹ̀ kan |
submission.customer_replied | ènìyàn fi ọ̀rọ̀, faili tàbí ìtẹ̀lé kún, tàbí tẹ bọ́tìnnì kan |
submission.deleted | a parẹ́ tàbí a pa á rẹ́ |
submit.automation_failed | automation kan fi sílẹ̀ lẹ́yìn àwọn ìgbìyànjú rẹ̀ |
Ọ̀kọ̀ọ̀kan nínú àwọn ọ̀nà wà pẹ̀lú gẹ́gẹ́ bí irinṣẹ́ lórí MCP server tí app2email ń gbàlejò, kí oluranlọwọ kan lè ṣe gbogbo ìṣètò nínú ìbánisọ̀rọ̀ kan: 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 àti bẹ́ẹ̀ bẹ́ẹ̀ lọ. Ìfiránṣẹ́ àkọ́kọ́ tó dára sí oluranlọwọ náà: "Ẹ ka ìtọ́sọ́nà Submit-Info, lẹ́yìn náà ẹ ṣètò fọ́ọ̀mù ìròyìn ìṣòro pẹ̀lú fọ́tò àti ibi, kí ẹ sì sọ fún àwọn manager mi nípa àwọn tí ó yára."
claude mcp add --transport http app2email https://api.app2email.com/mcp --header "Authorization: Bearer YOUR_API_KEY"Àlàyé síi lórí sísopọ̀ àwọn oluranlọwọ àti irinṣẹ́ automation: Irinṣẹ́ automation àti agent.
| Ààlà | Iye |
|---|---|
| Fọ́ọ̀mù fún nọ́mbà kan | 100 |
| Ìgbésẹ̀ nínú fọ́ọ̀mù kan, ìbéèrè nínú ìgbésẹ̀ kan | 12 àti 12 (ìbéèrè 60 nínú fọ́ọ̀mù kan, ìbéèrè ibi kan ṣoṣo) |
| Àtòjọ | 50, ọ̀kọ̀ọ̀kan tó 1,000 ìlà |
| Automation, ìsopọ̀, ọmọ ẹgbẹ́ | 200, 30, 200 |
| Faili nínú ìfisílẹ̀ kan | 60 |
| Ìwọ̀n faili | 25 MB láti WhatsApp, 10 MB láti ojú-ìwé wẹ́ẹ̀bù tàbí API |
| Àkọsílẹ̀ tàbí ìdáhùn kan | 4,000 ohun kikọ |
| Àwọn àmì lórí ìfisílẹ̀ kan | 20 |
| Ìpè sí àwọn ètò ìta | 60 ìpè ní ìṣẹ́jú kan àti 2,000 lọ́jọ́ fún nọ́mbà kan; ìṣẹ́jú-àáyá 15 àti 256 KB fún ìpè kan |
| Ìwé ìṣiṣẹ́ | a pa á mọ́ fún ọjọ́ 30 |
Gbogbo nǹkan tí a sọ lókè ni a ń ṣètò lórí ojú-ìwé Submit-Info nínú dashboard (/dashboard/app/submit). Ìbéèrè: support@app2email.com.