E-mailové notifikace

Kromě webhooků (zprávy pro váš systém) umí Signi posílat i e-mailové notifikace podepisujícím — upozornění navázaná na časové události dokumentu. Nastavují se při založení dokumentu polem email_notifications.

Typy notifikací

• after_send — připomínka: zadaný počet dní po vytvoření dokumentu znovu pošle výzvu k podpisu.
• before_sign_expiration — upozornění zadaný počet dní před expirací podepisování (dokument nebyl včas podepsán).

Příklad

Připomínka protistranám po 3 dnech + upozornění všem den před expirací:

{
    "people": [
        { "is_proposer": true, "email": "vas@email.cz", "contract_role": "sign",
          "positions": [ { "x": 50, "y": 20, "page": 0 } ] },
        { "is_proposer": false, "email": "josef@email.cz", "contract_role": "sign",
          "first_name": "Josef", "last_name": "Dvořák", "person_type": "nature",
          "positions": [ { "x": 20, "y": 80, "page": 0 } ] },
        { "is_proposer": false, "email": "jana@email.cz", "contract_role": "sign",
          "first_name": "Jana", "last_name": "Novotná", "person_type": "nature",
          "positions": [ { "x": 70, "y": 80, "page": 0 } ] }
    ],
    "email_notifications": [
        {
            "type": "after_send",
            "recipients": ["josef@email.cz", "jana@email.cz"],
            "days": 3
        },
        {
            "type": "before_sign_expiration",
            "recipients": ["vas@email.cz", "josef@email.cz", "jana@email.cz"],
            "days": 1
        }
    ],
    "file": "uploaded_file_key"
}

• type — typ notifikace (viz výše)
• recipients — komu se upozornění pošle
• days — počet dní (po vytvoření u after_send, před expirací u before_sign_expiration)

Co je dobré vědět

• Příjemci musí být podepisujícími dokumentu. Adresa, která na dokumentu není, se přeskočí — notifikace jí nepřijde.
• Kdo už svůj podpis dokončil, upozornění nedostane. A jakmile je dokument dokončený (nebo odmítnutý či expirovaný), nepošle se už nic.
• Když email_notifications nepošlete vůbec, Signi automaticky nastaví upozornění den před expirací pro všechny podepisující.

Odpověď při založení je stejná jako obvykle (contract_id, state, notifications s odkazy) — nastavení e-mailových notifikací se v ní nijak neukazuje.

Kam dál

• Webhooky — automatická hlášení změn stavu dokumentu — zprávy pro váš systém místo e-mailů
• Životní cyklus dokumentu