marcelocecin / TagUI-Podio

this tutorial is only for those who use the Podio Premium plan, because it needs Podio Workflow Automation PWA to do the automations

this tutorial also uses ProcFu script - Where PWA doesn't meet all of your needs, Procfu and Quivvy Tools can help

this example uses SSL certificate to protect the exchange of information on the internet

the list of authorized IPs was extracted from the PWA website

edit the api.key file for private key, current key is public

part of the app.python file was extracted from the repository flask-celery-example

1. install TagUI
2. install Celery with Redis and Flower
3. use app.py to run the API - tested on Ubuntu Linux server:
   • celery -A python.app.celery worker --concurrency=1
   • celery -A python.app.celery flower --certfile=ssl.crt --keyfile=ssl.key --basic_auth=user1:password1
   • gunicorn -w 3 -b :5000 -t 30 --reload python.wsgi:app --certfile=ssl.crt --keyfile=ssl.key --ssl-version=TLS_SERVER
4. create an app on Podio with a Multiline Text field and unique ID TAG with three decimal fields
   • the field in red Name is not necessary, I used it just to make it easier to find when there are many registered scripts
   • when including the script in the Multiline Text field, it is very important that the text is preformatted, otherwise the API will not save the TAG file on the server in the correct way

4. create the flow automations in the PWA of when an item is created and when an item is edited

5. create a last automation in PWA by date or day

6. this way the basic example script will run every day at the configured time

I will soon update this tutorial to show an example script and new API version that attaches the top_result.png image to Podio