Forgot password?

Sign up

PamFax – Develop for FREE – Pay when you’re ready


Tropo

PamFax is a cloud based faxing solution. Using PamFax in Tropo is really easy. All you need to do is sign up for a free PamFax account and download the Tropo pamfaxr gem from github. Then customize the gem with your PamFax account name and password and you can start sending faxes.



b1 Get a free PamFax account

First step is to sign up for a free account. This account includes three free pages (to the zone 1 countries – USA and all main industrial countries) so you can test the sending of faxes with the gem.

Sign up


b2 Get the PamFaxr gem


Click here for information on github how to use the PamFaxr gem to send a fax. Customize it to use your PamFax account credentials (username and password in below example) and change the destination fax number in the example (pamfaxr.add_recipient).

Note that the gem only supports the fax sending part of the PamFax API. If you want to add other PamFax features contact us at “Get support” below.



Requirements

Besides PamFaxr these gems are also required (present in the Gemfile):
* json
* mime-types


Example

Located in: examples/example.rb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

# Create a new PamFaxr object
 
pamfaxr = PamFaxr.new :username => 'your_username', 
                      :password => 'your_password'
 
# Create a new FaxJob
pamfaxr.create_fax_job
 
# Add the cover sheet
covers = pamfaxr.list_available_covers
pamfaxr.set_cover(covers['Covers']['content'][1]['id'], 'Foobar is here!')
 
# Add files
pamfaxr.add_remote_file('https://s3.amazonaws.com/pamfax-test/Tropo.pdf')
pamfaxr.add_file('examples/Tropo.pdf')
 
# Add a recipient
pamfaxr.add_recipient('+14155551212')
 
# Loop until the fax is ready to send
loop do
  fax_state = pamfaxr.get_state
  break if fax_state['FaxContainer']['state'] == 'ready_to_send'
  sleep 5
end
 
# Send the fax
pamfaxr.send_fax


b3 Get PamFax Credit


After you’ve tested pamfaxr and added fax to your application, you will need PamFax Credit to send faxes. Adding PamFax Credit is easy. Login to PamFax and click “Buy PamFax Credit” from the menu. Select the amount and checkout. Credit is added right after successful payment.



Get support

No worries, either ask the folks over at Tropo or open a support ticket – we’re happy to help where we can (technical or commercial questions, send them in).