add bang-example and modify urban function to use api

I would like to merge this into botboy; it fixes an issue and adds extra functionality.