Leum gu prìomh susbaint

Fuasgladh dhuilgheadasan le dearbhadh cuir air adhart

Tha an loidhne-phìob cuir air adhart a’ dearbhadh a shùbailteachd mus tòisich cruthachadh an sgrìobhainn. Ma thèid an dearbhadh seachad, thèid an tionndadh a-mach leis an fhàilligeadh air ais gu dìreach chun neach-dèiligidh agus chan eilear a’ toirt air ais ID gnìomh sam bith.

Bidh seo a’ buntainn ri:

Copy For Your AI

Cleachd seo nuair a tha thu a’ brosnachadh inneal AI gus cuideachadh le sruth-obrach sònraichte Legalesign GraphQL send:

Use the Legalesign GraphQL send validation rules below as the source of truth.

- Treat send input as strictly validated JSON.
- If send input is invalid, the mutation returns an error immediately and no task ID is returned.
- Only poll task after send succeeds and returns a task ID.
- For send workflows, monitor task.report.status until it reaches COMPLETED or FAILED.
- Prefer subscriptions over polling for production real-time UX.
- groupId, templateId, title, and recipients are required.
- Base64 IDs must decode to the expected prefixes:
groupId=grp, templateId=tpl, roleId=rol, scheduleId=sch, experience=exp, field id=ele, attachment id=att.
- recipients must contain fewer than 200 items.
- Each recipient must include email and order.
- The input must include an initial recipient: either order 0, or order 1 when roleId is provided.
- The recipient with the lowest order number must have a non-empty email.
- title must be 1028 characters or fewer.
- tag must be 250 characters or fewer.
- pdfPassword must be 150 characters or fewer.
- documentCCEmail must contain 10 email addresses or fewer.
- redirect must be a valid URI or null.

Ma dh’ fheumas an AI stiùireadh nas coileanta, seòl e chun duilleag seo.

Summary AI

  • Làimhsich inntrigeadh send mar JSON teann le riaghailtean dearbhaidh.
  • Ma tha inntrigeadh send mì-dhligheach, thèid mearachd a thoirt air ais gu sa bhad agus chan eil ID gnìomh air a thoirt air ais.
  • Dèan sùil air task a-mhàin às dèidh send a bhith soirbheachail agus ID gnìomh a thoirt air ais.
  • Airson sruth-obrach cuiridh air adhart, sùil a chumail air task.report.status gus am bi e COMPLETED no FAILED.
  • Airson eadar-aghaidh fìor-ùine sa phròiseas cinneasachaidh, is fheàrr fo-chrùban na sgrùdaidhean.

Mar a lorgas tu fàilligeadh ann an dearbhadh

Ruith an tionndadh mar as àbhaist.

  • Ma tha an inntrigeadh mì-dhligheach, thèid mearachd dearbhaidh a thoirt air ais sa bhad.
  • Ma tha an inntrigeadh dligheach, thèid ID gnìomh a thoirt air ais agus tha cruthachadh an sgrìobhainn a’ leantainn gu asynchroneach.

Tha sin a’ ciallachadh gu bheil fuasgladh dhuilgheadasan dearbhaidh a’ tachairt aig àm an tionndaidh, chan ann tro cheist task.

Tòisich a-mhàin a’ dèanamh sgrùdadh air task às dèidh send a bhith soirbheachail agus ID gnìomh a thoirt air ais.

Dè na seòrsaichean mhearachdan as urrainn dhut a bhith an dùil

Tha an neach-dhearbaidh cuiridh a’ sìoladh cruth agus susbaint na JSON inntrigidh mus lean pròiseasadh air adhart. Tha fàilligeadh dearbhaidh sònraichte don raon a dh’fhàillig, mar eisimpleir:

  • send input missing required field 'groupId'
  • send input.groupId must be a base64-encoded group id
  • send input.recipients must include a recipient with order 0, or order 1 when roleId is provided
  • recipients[0].email must be a valid email
  • recipients[1].attachments[0] must be a base64-encoded attachment id

Duilgheadasan cumanta ann an dearbhadh

Dleastanasan ìre àrd a chaidh an call

Tha na raointean sin riatanach:

  • groupId
  • templateId
  • title
  • recipients

IDan air an còdachadh gu mì-dhligheach

Tha an neach-dhearbaidh a’ dèanamh cinnteach gu bheil IDan air an còdachadh le base64 agus gu bheil am fearann-dearbhaidh a’ tòiseachadh leis an ro-ràdh dùilichte:

  • groupId -> grp
  • templateId -> tpl
  • roleId -> rol
  • scheduleId -> sch
  • experience -> exp
  • raon id -> ele
  • ceangal id -> att

Duilgheadasan ann an òrdachadh luchd-fhaighinn

Feumaidh an inntrigeadh cuiridh neach-fhaighinn tùsail a thoirt a-steach:

  • no neach-fhaighinn le order: 0
  • no neach-fhaighinn le order: 1 nuair a thèid roleId a thoirt seachad

Cuideachd, feumaidh an neach-fhaighinn leis an àireamh òrdugh as ìsle post-d nach eil falamh a bhith aige.

Cuingealachaidhean air raointean luchd-fhaighinn

Tha riaghailtean dearbhaidh cumanta airson luchd-fhaighinn a’ gabhail a-steach:

  • feumaidh email a bhith dligheach agus a bhith nas lugha no co-ionann ri 75 caractaran
  • feumaidh firstName agus lastName a bhith nas lugha no co-ionann ri 60 caractaran
  • feumaidh phoneNumber a bhith nas lugha no co-ionann ri 120 caractaran
  • feumaidh message a bhith nas lugha no co-ionann ri 10000 caractaran
  • feumaidh expiryDate a bhith ISO 8601 dligheach no null
  • feumaidh ccEmail a bhith dligheach
  • feumaidh ccIncludeLink a bhith na luach boolean

Cuingealachaidhean air raointean ìre àrd

Tha riaghailtean dearbhaidh cumanta airson ìre àrd cuiridh a’ gabhail a-steach:

  • feumaidh title a bhith nas lugha no co-ionann ri 1028 caractaran
  • feumaidh tag a bhith nas lugha no co-ionann ri 250 caractaran
  • feumaidh pdfPassword a bhith nas lugha no co-ionann ri 150 caractaran
  • feumaidh documentCCEmail a bhith aig a’ char as àirde 10 seòlaidhean post-d
  • feumaidh redirect a bhith URI dligheach no null
  • feumaidh recipients a bhith nas lugha na 200 nithean
  • feumaidh senderFields agus participantFields a bhith nas lugha na 1000 nithean gach fear

Cuir a-steach clàran-ama no raointean dligheach gu mì-dhligheach

Ma chuireas tu clàran-ama luchd-fhaighinn no luachan raointean air adhart gun cheangal:

  • feumaidh gach nì clàr-ama a bhith a’ toirt a-steach daysAfter, frequency, when, timeOfDay, subject, message, agus skipWeekend
  • feumaidh when a bhith aon de 1, 2, no 3
  • feumaidh subject agus message an clàr-ama a bhith nas lugha no co-ionann ri 500 caractaran
  • feumaidh gach inntrigeadh raon a bhith a’ gabhail a-steach ID eileamaid dligheach
  1. Dèan dearbhadh air an payload agad gu ionadail leis an Send Input JSON Schema.
  2. Ruith an tionndadh.
  3. Ma thig mearachd dearbhaidh air ais bhon tionndadh, ceart am payload agus feuch a-rithist.
  4. Ma thig ID gnìomh air ais, tòisich a’ dèanamh sgrùdadh air task gus sùil a chumail air cruthachadh an sgrìobhainn.

Cuin a chleachdas tu fo-chrùban an àite sin

Tha sgrùdadh air task freagarrach airson tòiseachadh, deuchainn, agus modaladh.

Airson sruth-obrach sa phròiseas cinneasachaidh, cleachd fo-chrùban airson ùrachaidhean fìor-ùine agus làimhsich inbhe an lorg air a sgrùdadh mar roghainn no inneal modaladh.

Airson stiùireadh sònraichte mu fo-chrùban a thaobh ghnìomhan, faic Track Send Tasks with Subscriptions.