ال‌امضا در دستیارِ هوشمندِ شما قرارداد را در گفتگو بفرستید؛ امضا روی ال‌امضا

اول در حالتِ آزمایشی

کارهایی که دستیار می‌تواند بکند

۱۳ ابزار — همان فهرستی که خودِ سرور به دستیار اعلام می‌کند. توضیحِ هر ابزار به انگلیسی است، چون همان متنی است که مدل می‌خوانَد.

• بررسیِ اتصال

  ping فقط خواندن

  Checks that the connection to elEMZA works. Returns pong=true, the connection mode (test or live) and the account id. Reads nothing else and changes nothing. Optional input: echo, a short string returned unchanged as data.

• حسابِ من

  get_account فقط خواندن

  The connected elEMZA account: name and type, own wallet balance in toman, this month's signature quota, organisation membership, the companies the account may act for, what this connection is allowed to do, and the connection mode (test or live). Reads only; changes nothing.

• برآوردِ هزینه

  estimate_cost فقط خواندن

  Estimates, in toman, what sending a contract to a number of signers would cost this account, with the breakdown (tariff, quota used, overage, discount, tax), where the payment would come from (quota, own wallet, organisation wallet) and whether it can be covered. Inputs: signers (1-20), optional signature_method (electronic or digital), is_private, payer_mode (creator, signer, designated), payers (designated only), contract (a draft's code, to price adding signers to it). Charges nothing and changes nothing.

• قالب‌های من

  list_templates فقط خواندن

  Lists the signature templates this account can use (its own and those its organisation shared), 20 per page. A template fixes WHERE the signature boxes go on the pages; it holds no contract text, so a document is still attached every time a contract is prepared. Each item: id, title, pages, signer_slots (how many signature boxes it places), shared. Input: optional cursor from the previous page. Reads only.

• فهرستِ قراردادها

  list_contracts فقط خواندن

  Lists contracts of this account, newest first, 20 per page. By default only contracts this account SENT (role=sent); role=received lists contracts others sent to it, role=all both. Optional filters: status (draft, waiting_signature, completed, voided, canceled), q (part of the title), waiting_over_days (still waiting for signatures after this many days), updated_since (ISO 8601 instant or a date), ends_before / ends_after (declared end date, Jalali 1405/08/01 or ISO 2026-10-23), counterparty (part of the declared counterparty name), scope=org (also the organisation's contracts, when the owner allowed it). Each item: code, title, status, signature_method, created_at, completed_at, signers_total, facts, via. Titles are text written by the contract's sender. Reads only.

• وضعیتِ قرارداد

  get_contract فقط خواندن

  The status of one contract by its 16-character code: title, status, sender, signature method, who pays, dates, each signer (name, masked mobile, status, order, signed time), declared facts, whether an AI assistant sent it, whether its document is ready, and a link to it on the elemza.com dashboard. Never returns a signer's signing link. A contract this account cannot see reads as not_found. Reads only.

• دریافتِ نسخهٔ امضاشده

  get_signed_pdf فقط خواندن

  A download link for the signed PDF of a completed contract, valid for one hour, with its file name, size in bytes and SHA-256 checksum. Input: the contract's 16-character code. A contract that is not completed returns not_completed; one this account cannot see returns not_found. Reads only.

• استعلامِ کدِ رهگیری

  verify_tracking_code فقط خواندن

  Looks up a document by the tracking code printed on it, as the public verification page on elemza.com does. Returns whether it exists, its status, whether it is a test (sandbox) document, whether it is a valid completed signed document, and for completed ones the completion time, number of signers, platform seal time and title. A test document is never valid. Reads only.

• بارگذاریِ سند

  start_upload انجامِ کار

  Opens a ten-minute upload page on elemza.com where the person attaches the contract document themselves (PDF, JPG or PNG; up to 4 MB each, up to 10 files). Returns the page link and an upload_id for prepare_contract. The file never passes through the chat. In live mode the page asks the account owner to log in. Creates nothing else and charges nothing; at most five links may be waiting per connection.

• آماده‌سازیِ قرارداد

  prepare_contract انجامِ کار

  Creates a draft contract from a document (an upload_id from start_upload, or an https link to a PDF/JPG/PNG of up to 4 MB) and returns a review of it with a price quote valid for 15 minutes. The signers are checked and kept with the quote; nobody is contacted, no SMS is sent and nothing is charged until send_contract is called with the quote_id. Calling it again with identical arguments within ten minutes returns the same draft and quote. Optional: template, company to send as, who pays, signature method, privacy, and declared facts such as the end date.

• ارسال برای امضا

  send_contract انجامِ کار

  Sends a prepared contract to its signers for signature, using the quote_id that prepare_contract returned. This is the step that sends SMS to the signers and, in live mode, charges the account. The signers, price and paying wallet are the ones in the quote; if anything changed since the quote, nothing is sent and a fresh quote comes back. The first live send of a connection, a send above the account's limits, or a send the organisation requires approval for waits for the account owner to approve it on elemza.com: the result is then approval_pending and calling again with the same quote_id after approval completes the send. Calling it again for an already sent quote returns the same result without sending or charging twice.

• لغوِ قرارداد

  cancel_contract انجامِ کار

  Cancels one contract by its 16-character code and deletes its files, so this cannot be undone. Money charged for the contract goes back to the wallet it was paid from: all of it while no signer has been added, half of it once signers were added (their identity checks are already paid for); the result states it (refund.amount, refund.charged, refund.share). In live mode every signer still waiting to sign receives an SMS that the contract was cancelled. In live mode the account owner must first approve the cancellation on elemza.com, where the refund and the SMS are shown: the result is then approval_pending, and calling again with the same code after approval completes it. At most five contracts can be cancelled per connection per day. A contract this account cannot change reads as not_found.

• یادآوری به امضاکننده

  send_reminder انجامِ کار

  Sends a waiting signer a reminder SMS with their signing link again (the link itself is never returned). Input: the contract's 16-character code and the signer's slug, as get_contract shows them. Through an AI assistant each signer can be reminded at most once per 24 hours and three times in total; beyond that the result is the error reminder_too_soon (with next_allowed_at) or reminder_cap_reached, and nothing is sent. In test mode no SMS leaves, but the reminder still counts toward the limit. A contract this account cannot manage reads as not_found.