How can I add integration for a newsletter service?

Troy Wolbrink — Tue, 09 Jan 2018 22:45:48 GMT

Current revision posted to Frequently Asked Questions by Troy Wolbrink on 1/9/2018 10:45:48 PM

How can I add integration for a newsletter service?

Filed under: Developer Guides

You need to host a simple text file on your site that describes to TntConnect what your various endpoints are. It's in the "ini" format. As an example, here's some actual endpoints:

[simple] http://www.chalkline.org/ini.txt
[advanced] http://www.prayerletters.com/tntmpd/integration.ini

The ini file has several sections ( //comments in blue should not be in actual file):

[APPLICATION]
MinimumVersion=3.0.173.4.8 // minimum version of TntConnect required
RecommendedVersion=3.0.173.4.8 // recommended version of TntConnect

[LetterService]
// if you move your query.ini url, you can put in a redirect here to update TntConnect
RedirectQueryIni=
// url to your logo (300x100)
LogoUrl=http://www.example.com/static/images/logo100.png
// url for new customer to learn about your service
AboutUrl=http://www.example.com/tntconnect

// for simple integration, just provide a url to TntConnect-specific instructions … done! … stop here
HowToOrderUrl=http://www.example.org/TntConnectInstructions.pdf

// advanced: optional way to allow for authentication persistence via OAUTH access token
AuthorizationRequestUrl=https://www.example.com/tntconnect/authorize?tntdb=$TNTCONNECT_DATABASE$&redirect_uri={redirect_uri}

// advanced: optional endpoint for TntConnect to exchange a temporary token with a real token
AuthorizationCompleteUrl=https://www.example.com/tntconnect/token?code={code}&redirect_uri={redirect_uri}

// advanced: optional endpoint for TntConnect to revoke access tokens
AuthorizationRevokeUrl=https://www.example.com/tntconnect/authorize_revoke?token=$ACCESS_TOKEN$

// deprecated: optional way to allow for authentication persistence via OAUTH access token
AccessTokenRequestUrl=https://www.example.com/tntconnect/authorize?tntdb=$TNTCONNECT_DATABASE$
AccessTokenCompleteUrl=https://www.example.com/tntconnect/authorize_callback

// advanceddeprecated: optional endpoint for TntConnect to revoke access tokens
AccessTokenRevokeUrl=https://www.example.com/tntconnect/authorize_revoke?token=$ACCESS_TOKEN$

// advanced integration: provide url to upload CSV of partners
// return url to launch in user's default browser to complete order
CsvInvariantFieldNames=True
CsvLocalizedFieldNames=False
CsvUploadUrl=https://www.example.com/tntconnect/upload_file?v=1&ACCESS_TOKEN$

For simple integration...

You can stop with "HowToOrderUrl".

[LetterService]
LogoUrl=http://www.chalkline.org/CL_logo.jpg
AboutUrl=http://www.chalkline.org/
HowToOrderUrl=http://www.chalkline.org/order_ev_tnt.html

The integration will look like this:

For advanced integration...

You must provide the "CsvUploadUrl". The integration will look like this:

Authentication is optional, but if you want to provide TntConnect with an OAUTH token, you can. The benefit is that the user doesn't have to login to your service each month to send their newsletter.

Deprecated Info

To provide for OAUTH authentication, you must provide the following endpoints:

AccessTokenRequestUrl
AccessTokenCompleteUrl

If you include $TNTCONNECT_DATABASE$ in your AccessTokenRequestUrl, it will be substituted for the name of the current TntConnect database file. (Prior to TntConnect 3.1.11, only $TNTMPD_DATABASE$ will be recognized.) This way you can associate tokens with TntConnect databases for future reference. Once user is logged in, redirect the user to the AccessTokenCompleteUrl with the access token in the fragment portion of the url as #access_token=xxxxx In the CsvUploadUrl, $ACCESS_TOKEN$ is substituted for the OAUTH access token.

To provide for OAUTH authentication, you must provide the following endpoint:

AuthorizationRequestUrl

If you include $TNTCONNECT_DATABASE$ in your AccessTokenRequestUrl, it will be substituted for the name of the current TntConnect database file. This way you can associate tokens with TntConnect databases for future reference.

Once user is logged in (and approves access), redirect the user to the {redirect_uri} provided by TntConnect. You can either:

modified OAuth 2.0 "Implicit": Return the access token directly by adding an "access_token" parameter to the redirect_uri url.
OAuth 2.0 "Authorization Code": Or you can return a temporary "authorization code" by adding a "code" query string parameter. TntConnect will send that code to the AuthorizationCompleteUrl (in place of the {code} placeholder). TntConnect will also include the original {redirect_uri} used. The access token will then be returned via json as an "access_token" member (as per the OAuth 2.0 spec).

If an error occurs, you can redirect the user back to the redirect_uri with an "error" query string parameter (and optionally and "error_description"). "access_denied" is what's expected as the "error" if the user simply cancels.

If you don't want to support an OAUTH access token, don't include any of the AccessToken* urls, and don't include $ACCESS_TOKEN$ in our CsvUploadUrl.

CsvUploadUrl

TntConnect will POST the current group as UTF-8 CSV text in the body of request.

By default, the non-localized field names are included as column headers. But you can control the field names via the CsvInvariantFieldNames and CsvLocalizedFieldNames settings. These are True/False settings. You can include both as True! If you do, invariant (non-localized) field names will always be on the first row, and the localized field names will be on the 2nd row. You might want to include localized field names because these match up better to the mail merge fields in documents uploaded by the user. But you might also want non-localized field names so you when you receive CSV uploads from non-English versions of TntConnect, you know what the fields stand for (i.e. you know which field is the Mailing Address Block for envelopes).

If there is an error, the service should return:

HTTP 401 if access token is invalid and needs to be reaquired.
or HTTP status 200, with “ERROR” on first line of body, actual error message on 2nd line.

ERROR
Example error message

If successful, return either:

HTTP 200, with body of “LaunchBrowserUrl=xxxxxx”

LaunchBrowserUrl=http://www.example.com/startorder?id=123123
or a standard HTTP redirect (HTTP 301/302/303 w/ Location header)

The user's default browser will then be launched with the url returned so they can complete the order.

HOW TO TEST

To test your ini url, hold down the Ctrl (or Command key on a Mac) key and right-click on the drop down list:

READY?

When you have your url ready, send me an email at: troy@tntware.com. Tell me the NAME and URL in the email. Once I add you to the official list, TntConnect will be updated immediately.

How can I add integration for a newsletter service?

Troy Wolbrink — Wed, 15 Jun 2016 17:14:09 GMT

Revision 8 posted to Frequently Asked Questions by Troy Wolbrink on 6/15/2016 5:14:09 PM

How can I add integration for a newsletter service?

Filed under: Developer Guides

You need to host a simple text file on your site that describes to TntConnect what your various endpoints are. It's in the "ini" format. As an example, here's some actual endpoints:

[simple] http://www.chalkline.org/ini.txt
[advanced] http://www.prayerletters.com/tntmpd/integration.ini

The ini file has several sections ( //comments in blue should not be in actual file):

[APPLICATION]
MinimumVersion=3.0.17 // minimum version of TntConnect required
RecommendedVersion=3.0.17 // recommended version of TntConnect

[LetterService]
// if you move your query.ini url, you can put in a redirect here to update TntConnect
RedirectQueryIni=
// url to your logo (300x100)
LogoUrl=http://www.example.com/static/images/logo100.png
// url for new customer to learn about your service
AboutUrl=http://www.example.com/tntconnect

// for simple integration, just provide a url to TntConnect-specific instructions … done! … stop here
HowToOrderUrl=http://www.example.org/TntConnectInstructions.pdf

// advanced: optional way to allow for authentication persistence via OAUTH access token
AccessTokenRequestUrl=https://www.example.com/tntconnect/authorize?tntdb=$TNTCONNECT_DATABASE$
AccessTokenCompleteUrl=https://www.example.com/tntconnect/authorize_callback

// advanced: optional endpoint for TntConnect to revoke access tokens
AccessTokenRevokeUrl=https://www.example.com/tntconnect/authorize_revoke?token=$ACCESS_TOKEN$

// advanced integration: provide url to upload CSV of partners
// return url to launch in user's default browser to complete order
CsvInvariantFieldNames=True
CsvLocalizedFieldNames=False
CsvUploadUrl=https://www.example.com/tntconnect/upload_file?v=1&ACCESS_TOKEN$

For simple integration...

You can stop with "HowToOrderUrl".

[LetterService]
LogoUrl=http://www.chalkline.org/CL_logo.jpg
AboutUrl=http://www.chalkline.org/
HowToOrderUrl=http://www.chalkline.org/order_ev_tnt.html

The integration will look like this:

For advanced integration...

You must provide the "CsvUploadUrl". The integration will look like this:

Authentication is optional, but if you want to provide TntMPD TntConnect with an OAUTH token, you can. The benefit is that the user doesn't have to login to your service each month to send their newsletter. To provide for OAUTH authentication, you must provide the following endpoints:

AccessTokenRequestUrl
AccessTokenCompleteUrl

If you include $TNTMPD_DATABASE$ TNTCONNECT_DATABASE$ in your AccessTokenRequestUrl, it will be substituted for the name of the current TntMPD TntConnect database file. (Prior to TntConnect 3.1.11, only $TNTMPD_DATABASE$ will be recognized.) This way you can associate tokens with TntMPD TntConnect databases for future reference. Once user is logged in, redirect the user to the AccessTokenCompleteUrl with the access token in the fragment portion of the url as #access_token=xxxxx In the CsvUploadUrl, $ACCESS_TOKEN$ is substituted for the OAUTH access token.

If you don't want to support an OAUTH access token, don't include any of the AccessToken* urls, and don't include $ACCESS_TOKEN$ in our CsvUploadUrl.

CsvUploadUrl

TntMPD

TntConnect will POST the current group as UTF-8 CSV text in the body of request.

By default, the non-localized field names are included as column headers. But you can control the field names via the CsvInvariantFieldNames and CsvLocalizedFieldNames settings. These are True/False settings. You can include both as True! If you do, invariant (non-localized) field names will always be on the first row, and the localized field names will be on the 2nd row. You might want to include localized field names because these match up better to the mail merge fields in documents uploaded by the user. But you might also want non-localized field names so you when you receive CSV uploads from non-English versions of TntMPDTntConnect, you know what the fields stand for (i.e. you know which field is the Mailing Address Block for envelopes).

If there is an error, the service should return:

HTTP 401 if access token is invalid and needs to be reaquired.
or HTTP status 200, with “ERROR” on first line of body, actual error message on 2nd line.

ERROR
Example error message

If successful, return either:

HTTP 200, with body of “LaunchBrowserUrl=xxxxxx”

LaunchBrowserUrl=http://www.example.com/startorder?id=123123
or a standard HTTP redirect (HTTP 301/302/303 w/ Location header)

The user's default browser will then be launched with the url returned so they can complete the order.

HOW TO TEST

To test your ini url, hold down the Ctrl (or Command key on a Mac) key and right-click on the drop down list:

READY?

When you have your url ready, send me an email at: troy@tntware.com. Tell me the NAME and URL in the email. Once I add you to the official list, TntMPD TntConnect will be updated immediately.

How can I add integration for a newsletter service?

Troy Wolbrink — Wed, 15 Jun 2016 17:10:29 GMT

Revision 7 posted to Frequently Asked Questions by Troy Wolbrink on 6/15/2016 5:10:29 PM

How can I add integration for a newsletter service?

Filed under: Developer Guides

You need to host a simple text file on your site that describes to TntMPD TntConnect what your various endpoints are. It's in the "ini" format. As an example, here's some actual endpoints:

[simple] http://www.chalkline.org/ini.txt
[advanced] http://www.prayerletters.com/tntmpd/integration.ini

The ini file has several sections ( //comments in blue should not be in actual file):

[APPLICATION]
MinimumVersion=3.0.17 // minimum version of TntMPD TntConnect required
RecommendedVersion=3.0.17 // recommended version of TntMPDTntConnect

[LetterService]
// if you move your query.ini url, you can put in a redirect here to update TntMPDTntConnect
RedirectQueryIni=
// url to your logo (300x100)
LogoUrl=http://www.example.com/static/images/logo100.png
// url for new customer to learn about your service
AboutUrl=http://www.example.com/tntmpdhttp://www.example.com/tntconnect

// for simple integration, just provide a url to TntMPD-specific TntConnect-specific instructions … done! … stop here
HowToOrderUrl=http://www.example.org/TNTMPDInstructions.pdfhttp://www.example.org/TntConnectInstructions.pdf

// advanced: optional way to allow for authentication persistence via OAUTH access token
AccessTokenRequestUrl=https://www.example.com/tntmpd/authorize?tntdb=$TNTMPD_DATABASE$https://www.example.com/tntconnect/authorize?tntdb=$TNTCONNECT_DATABASE$
AccessTokenCompleteUrl=https://www.example.com/tntmpd/authorize_callbackhttps://www.example.com/tntconnect/authorize_callback

// advanced: optional endpoint for TntMPD TntConnect to revoke access tokens
AccessTokenRevokeUrl=https://www.example.com/tntmpd/authorize_revoke?token=$ACCESS_TOKEN$https://www.example.com/tntconnect/authorize_revoke?token=$ACCESS_TOKEN$

// advanced integration: provide url to upload CSV of partners
// return url to launch in user's default browser to complete order
CsvInvariantFieldNames=True
CsvLocalizedFieldNames=False
CsvUploadUrl=https://www.example.com/tntmpd/upload_file?v=1https://www.example.com/tntconnect/upload_file?v=1&ACCESS_TOKEN$

For simple integration...

You can stop with "HowToOrderUrl".

[LetterService]
LogoUrl=http://www.chalkline.org/CL_logo.jpg
AboutUrl=http://www.chalkline.org/
HowToOrderUrl=http://www.chalkline.org/order_ev_tnt.html

The integration will look like this:

For advanced integration...

You must provide the "CsvUploadUrl". The integration will look like this:

Authentication is optional, but if you want to provide TntMPD with an OAUTH token, you can. The benefit is that the user doesn't have to login to your service each month to send their newsletter. To provide for OAUTH authentication, you must provide the following endpoints:

AccessTokenRequestUrl
AccessTokenCompleteUrl

If you include $TNTMPD_DATABASE$ in your AccessTokenRequestUrl, it will be substituted for the name of the current TntMPD database file. This way you can associate tokens with TntMPD databases for future reference. Once user is logged in, redirect the user to the AccessTokenCompleteUrl with the access token in the fragment portion of the url as #access_token=xxxxx In the CsvUploadUrl, $ACCESS_TOKEN$ is substituted for the OAUTH access token.

If you don't want to support an OAUTH access token, don't include any of the AccessToken* urls, and don't include $ACCESS_TOKEN$ in our CsvUploadUrl.

CsvUploadUrl

TntMPD will POST the current group as UTF-8 CSV text in the body of request.

By default, the non-localized field names are included as column headers. But you can control the field names via the CsvInvariantFieldNames and CsvLocalizedFieldNames settings. These are True/False settings. You can include both as True! If you do, invariant (non-localized) field names will always be on the first row, and the localized field names will be on the 2nd row. You might want to include localized field names because these match up better to the mail merge fields in documents uploaded by the user. But you might also want non-localized field names so you when you receive CSV uploads from non-English versions of TntMPD, you know what the fields stand for (i.e. you know which field is the Mailing Address Block for envelopes).

If there is an error, the service should return:

HTTP 401 if access token is invalid and needs to be reaquired.
or HTTP status 200, with “ERROR” on first line of body, actual error message on 2nd line.

ERROR
Example error message

If successful, return either:

HTTP 200, with body of “LaunchBrowserUrl=xxxxxx”

LaunchBrowserUrl=http://www.example.com/startorder?id=123123
or a standard HTTP redirect (HTTP 301/302/303 w/ Location header)

The user's default browser will then be launched with the url returned so they can complete the order.

HOW TO TEST

To test your ini url, hold down the Ctrl (or Command key on a Mac) key and right-click on the drop down list:

READY?

When you have your url ready, send me an email at: troy@wolbrinkfamily.com troy@tntware.com. Tell me the NAME and URL in the email. Once I add you to the official list, TntMPD will be updated immediately.

How can I add integration for a newsletter service?

Troy Wolbrink — Thu, 26 Jun 2014 16:26:33 GMT

Revision 6 posted to Frequently Asked Questions by Troy Wolbrink on 6/26/2014 4:26:33 PM

How can I add integration for a newsletter service?

Filed under: Developer Guides

You need to host a simple text file on your site that describes to TntMPD what your various endpoints are. It's in the "ini" format. As an example, here's some actual endpoints:

[simple] http://www.chalkline.org/ini.txt
[advanced] http://www.prayerletters.com/tntmpd/integration.ini

The ini file has several sections ( //comments in blue should not be in actual file):

[APPLICATION]
MinimumVersion=3.0.17 // minimum version of TntMPD required
RecommendedVersion=3.0.17 // recommended version of TntMPD

[LetterService]
// if you move your query.ini url, you can put in a redirect here to update TntMPD
RedirectQueryIni=
// url to your logo (300x100)
LogoUrl=http://www.example.com/static/images/logo100.png
// url for new customer to learn about your service
AboutUrl=http://www.example.com/tntmpd

// for simple integration, just provide a url to TntMPD-specific instructions … done! … stop here
HowToOrderUrl=http://www.example.org/TNTMPDInstructions.pdf

// advanced: optional way to allow for authentication persistence via OAUTH access token
AccessTokenRequestUrl=https://www.example.com/tntmpd/authorize?tntdb=$TNTMPD_DATABASE$
AccessTokenCompleteUrl=https://www.example.com/tntmpd/authorize_callback

// advanced: optional endpoint for TntMPD to revoke access tokens
AccessTokenRevokeUrl=https://www.example.com/tntmpd/authorize_revoke?token=$ACCESS_TOKEN$

// advanced integration: provide url to upload CSV of partners
// return url to launch in user's default browser to complete order
CsvInvariantFieldNames=True
CsvLocalizedFieldNames=False
CsvUploadUrl=https://www.example.com/tntmpd/upload_file?v=1&ACCESS_TOKEN$

For simple integration...

You can stop with "HowToOrderUrl".

[LetterService]
LogoUrl=http://www.chalkline.org/CL_logo.jpg
AboutUrl=http://www.chalkline.org/
HowToOrderUrl=http://www.chalkline.org/order_ev_tnt.html

The integration will look like this:

For advanced integration...

You must provide the "CsvUploadUrl". The integration will look like this:

AccessTokenRequestUrl
AccessTokenCompleteUrl

If you don't want to support an OAUTH access token, don't include any of the AccessToken* urls, and don't include $ACCESS_TOKEN$ in our CsvUploadUrl.

CsvUploadUrl

HTTP 401 if access token is invalid and needs to be reaquired.
or HTTP status 200, with “ERROR” on first line of body, actual error message on 2nd line.

ERROR
Example error message

If successful, return either:

HTTP 200, with body of “LaunchBrowserUrl=xxxxxx”

LaunchBrowserUrl=http://www.example.com/startorder?id=123123
or a standard HTTP redirect (HTTP 301/302/303 w/ Location header)

The user's default browser will then be launched with the url returned so they can complete the order.

HOW TO TEST

To test your ini url, hold down the Ctrl (or Command key on a Mac) key and right-click on the drop down list:

READY?

When you have your url ready, send me an email at: troy.wolbrink@ccci.org troy@wolbrinkfamily.com. Tell me the NAME and URL in the email. Once I add you to the official list, TntMPD will be updated immediately.

How can I add integration for a newsletter service?

Troy Wolbrink — Thu, 19 Sep 2013 15:03:33 GMT

Revision 5 posted to Frequently Asked Questions by Troy Wolbrink on 9/19/2013 3:03:33 PM

How can I add integration for a newsletter service?

Filed under: Developer Guides

You need to host a simple text file on your site that describes to TntMPD what your various endpoints are. It's in the "ini" format. As an example, here's some actual endpoints:

[simple] http://www.chalkline.org/ini.txt
[advanced] http://www.prayerletters.com/tntmpd/integration.ini

The ini file has several sections ( //comments in blue should not be in actual file):

[APPLICATION]
MinimumVersion=3.0.17 // minimum version of TntMPD required
RecommendedVersion=3.0.17 // recommended version of TntMPD

[LetterService]
// if you move your query.ini url, you can put in a redirect here to update TntMPD
RedirectQueryIni=
// url to your logo (300x100)
LogoUrl=http://www.example.com/static/images/logo100.png
// url for new customer to learn about your service
AboutUrl=http://www.example.com/tntmpd

// for simple integration, just provide a url to TntMPD-specific instructions … done! … stop here
HowToOrderUrl=http://www.example.org/TNTMPDInstructions.pdf

// advanced: optional way to allow for authentication persistence via OAUTH access token
AccessTokenRequestUrl=https://www.example.com/tntmpd/authorize?tntdb=$TNTMPD_DATABASE$
AccessTokenCompleteUrl=https://www.example.com/tntmpd/authorize_callback

// advanced: optional endpoint for TntMPD to revoke access tokens
AccessTokenRevokeUrl=https://www.example.com/tntmpd/authorize_revoke?token=$ACCESS_TOKEN$

// advanced integration: provide url to upload CSV of partners
// return url to launch in user's default browser to complete order
CsvFieldNamesAreLocalized
CsvInvariantFieldNames=FALSETrue
CsvLocalizedFieldNames=False
CsvUploadUrl=https://www.example.com/tntmpd/upload_file?v=1&ACCESS_TOKEN$

For simple integration...

You can stop with "HowToOrderUrl". The integration will look like this:

For advanced integration...

You must provide the "CsvUploadUrl". The integration will look like this:

AccessTokenRequestUrl
AccessTokenCompleteUrl

If you don't want to support an OAUTH access token, don't include any of the AccessToken* urls, and don't include $ACCESS_TOKEN$ in our CsvUploadUrl.

CsvUploadUrl

HTTP 401 if access token is invalid and needs to be reaquired.
or HTTP status 200, with “ERROR” on first line of body, actual error message on 2nd line.

ERROR
Example error message

If successful, return either:

HTTP 200, with body of “LaunchBrowserUrl=xxxxxx”

LaunchBrowserUrl=http://www.example.com/startorder?id=123123
or a standard HTTP redirect (HTTP 301/302/303 w/ Location header)

The user's default browser will then be launched with the url returned so they can complete the order.

HOW TO TEST

To test your ini url, hold down the Ctrl (or Command key on a Mac) key and right-click on the drop down list:

READY?

When you have your url ready, send me an email at: troy.wolbrink@ccci.org. Tell me the NAME and URL in the email. Once I add you to the official list, TntMPD will be updated immediately.

How can I add integration for a newsletter service?

Troy Wolbrink — Wed, 18 Sep 2013 19:57:52 GMT

Revision 4 posted to Frequently Asked Questions by Troy Wolbrink on 9/18/2013 7:57:52 PM

How can I add integration for a newsletter service?

Filed under: Developer Guides

You need to host a simple text file on your site that describes to TntMPD what your various endpoints are. It's in the "ini" format. As an example, here's some actual endpoints:

[simple] http://www.chalkline.org/ini.txt
[advanced] http://www.prayerletters.com/tntmpd/integration.ini

The ini file has several sections ( //comments in blue should not be in actual file):

[APPLICATION]
MinimumVersion=3.0.17 // minimum version of TntMPD required
RecommendedVersion=3.0.17 // recommended version of TntMPD

[LetterService]
// if you move your query.ini url, you can put in a redirect here to update TntMPD
RedirectQueryIni=
// url to your logo (300x100)
LogoUrl=http://www.example.com/static/images/logo100.png
// url for new customer to learn about your service
AboutUrl=http://www.example.com/tntmpd

// for simple integration, just provide a url to TntMPD-specific instructions … done! … stop here
HowToOrderUrl=http://www.example.org/TNTMPDInstructions.pdf

// advanced: optional way to allow for authentication persistence via OAUTH access token
AccessTokenRequestUrl=https://www.example.com/tntmpd/authorize?tntdb=$TNTMPD_DATABASE$
AccessTokenCompleteUrl=https://www.example.com/tntmpd/authorize_callback

// advanced: optional endpoint for TntMPD to revoke access tokens
AccessTokenRevokeUrl=https://www.example.com/tntmpd/authorize_revoke?token=$ACCESS_TOKEN$

// advanced integration: provide url to upload CSV of partners
// return url to launch in user's default browser to complete order
CsvFieldNamesAreLocalized=FALSE
CsvUploadUrl=https://www.example.com/tntmpd/upload_file?v=1&ACCESS_TOKEN$

For simple integration...

You can stop with "HowToOrderUrl". The integration will look like this:

For advanced integration...

You must provide the "CsvUploadUrl". The integration will look like this:

AccessTokenRequestUrl
AccessTokenCompleteUrl

If you don't want to support an OAUTH access token, don't include any of the AccessToken* urls, and don't include $ACCESS_TOKEN$ in our CsvUploadUrl.

CsvUploadUrl

TntMPD will POST the current group as UTF-8 CSV text in the body of request.

If there is an error, the service should return:

HTTP 401 if access token is invalid and needs to be reaquired.
or HTTP status 200, with “ERROR” on first line of body, actual error message on 2nd line.

ERROR
Example error message

If successful, return either:

HTTP 200, with body of “LaunchBrowserUrl=xxxxxx”

LaunchBrowserUrl=http://www.example.com/startorder?id=123123
or a standard HTTP redirect (HTTP 301/302/303 w/ Location header)

The user's default browser will then be launched with the url returned so they can complete the order.

HOW TO TEST

To test your ini url, hold down the Ctrl (or Command key on a Mac) key and right-click on the drop down list:

READY?

When you have your url ready, send me an email at: troy.wolbrink@ccci.org. Tell me the NAME and URL in the email. Once I add you to the official list, TntMPD will be updated immediately.

How can I add integration for a newsletter service?

Troy Wolbrink — Wed, 18 Sep 2013 19:56:23 GMT

Revision 3 posted to Frequently Asked Questions by Troy Wolbrink on 9/18/2013 7:56:23 PM

How can I add integration for a newsletter service?

Filed under: Developer Guides

You need to host a simple text file on your site that describes to TntMPD what your various endpoints are. It's in the "ini" format. As an example, here's some actual endpoints:

[simple] http://www.chalkline.org/ini.txt
[advanced] http://www.prayerletters.com/tntmpd/integration.ini

The ini file has several sections ( //comments in blue should not be in actual file):

[APPLICATION]
MinimumVersion=3.0.17 // minimum version of TntMPD required
RecommendedVersion=3.0.17 // recommended version of TntMPD

[LetterService]
// if you move your query.ini url, you can put in a redirect here to update TntMPD
RedirectQueryIni=
// url to your logo (300x100)
LogoUrl=http://www.example.com/static/images/logo100.png
// url for new customer to learn about your service
AboutUrl=http://www.example.com/tntmpd

// for simple integration, just provide a url to TntMPD-specific instructions … done! … stop here
HowToOrderUrl=http://www.example.org/TNTMPDInstructions.pdf

// advanced: optional way to allow for authentication persistence via OAUTH access token
AccessTokenRequestUrl=https://www.example.com/tntmpd/authorize?tntdb=$TNTMPD_DATABASE$
AccessTokenCompleteUrl=https://www.example.com/tntmpd/authorize_callback

// advanced: optional endpoint for TntMPD to revoke access tokens
AccessTokenRevokeUrl=https://www.example.com/tntmpd/authorize_revoke?token=$ACCESS_TOKEN$

// advanced integration: provide url to upload CSV of partners
// return url to launch in user's default browser to complete order
CsvFieldNamesAreLocalized=FALSE
CsvUploadUrl=https://www.example.com/tntmpd/upload_file?v=1&ACCESS_TOKEN$

For simple integration...

You can stop with "HowToOrderUrl". The integration will look like this:

For advanced integration...

you

You must provide the "CsvUploadUrl". The integration will look like this:

AccessTokenRequestUrl
AccessTokenCompleteUrl

If you don't want to support an OAUTH access token, don't include any of the AccessToken* urls, and don't include $ACCESS_TOKEN$ in our CsvUploadUrl.

CsvUploadUrl

TntMPD will POST the current group as UTF-8 CSV text in the body of request.

If there is an error, the service should return:

HTTP 401 if access token is invalid and needs to be reaquired.
or HTTP status 200, with “ERROR” on first line of body, actual error message on 2nd line.

ERROR
Example error message

If successful, return either:

HTTP 200, with body of “LaunchBrowserUrl=xxxxxx”
or a standard HTTP redirect (HTTP 301/302/303 w/ Location header)

The user's default browser will then be launched with the url returned so they can complete the order.

HOW TO TEST

To test your ini url, hold down the Ctrl (or Command key on a Mac) key and right-click on the drop down list:

READY?

When you have your url ready, send me an email at: troy.wolbrink@ccci.org. Tell me the NAME and URL in the email. Once I add you to the official list, TntMPD will be updated immediately.

How can I add integration for a newsletter service?

Troy Wolbrink — Wed, 18 Sep 2013 19:53:10 GMT

Revision 2 posted to Frequently Asked Questions by Troy Wolbrink on 9/18/2013 7:53:10 PM

How can I add integration for a newsletter service?

Filed under: Developer Guides

You need to host a simple text file on your site that describes to TntMPD what your various endpoints are. It's in the "ini" format. As an example, here's some actual endpoints:

[simple] http://www.chalkline.org/ini.txt
[advanced] http://www.prayerletters.com/tntmpd/integration.ini

The ini file has several sections ( //comments in blue should not be in actual file):

[APPLICATION]
MinimumVersion=3.0.17 // minimum version of TntMPD required
RecommendedVersion=3.0.17 // recommended version of TntMPD

[LetterService]
// if you move your query.ini url, you can put in a redirect here to update TntMPD
RedirectQueryIni=
// url to your logo (300x100)
LogoUrl=http://www.example.com/static/images/logo100.png
// url for new customer to learn about your service
AboutUrl=http://www.example.com/tntmpd

// for simple integration, just provide a url to TntMPD-specific instructions … done! … stop here
HowToOrderUrl=http://www.example.org/TNTMPDInstructions.pdf

// advanced: optional way to allow for authentication persistence via OAUTH access token
AccessTokenRequestUrl=https://www.example.com/tntmpd/authorize?tntdb=$TNTMPD_DATABASE$
AccessTokenCompleteUrl=https://www.example.com/tntmpd/authorize_callback

// advanced: optional endpoint for TntMPD to revoke access tokens
AccessTokenRevokeUrl=https://www.example.com/tntmpd/authorize_revoke?token=$ACCESS_TOKEN$

// advanced integration: provide url to upload CSV of partners
// return url to launch in user's default browser to complete order
CsvFieldNamesAreLocalized=FALSE
CsvUploadUrl=https://www.example.com/tntmpd/upload_file?v=1&ACCESS_TOKEN$

For simple integration, you integration...

You can stop with "HowToOrderUrl". The integration will look like this:

For advanced integration, integration...

you must provide the "CsvUploadUrl". The integration will look like this:

AccessTokenRequestUrl
AccessTokenCompleteUrl

If you don't want to support an OAUTH access token, don't include any of the AccessToken* urls, and don't include $ACCESS_TOKEN$ in our CsvUploadUrl.

CsvUploadUrl

TntMPD will POST the current group as UTF-8 CSV text in the body of request.

If there is an error, the service should return:

HTTP 401 if access token is invalid and needs to be reaquired.
or HTTP status 200, with “ERROR” on first line of body, actual error message on 2nd line.

ERROR
Example error message

If successful, return either:

HTTP 200, with body of “LaunchBrowserUrl=xxxxxx”
or a standard HTTP redirect (HTTP 301/302/303 w/ Location header)

The user's default browser will then be launched with the url returned so they can complete the order.

HOW TO TEST

To test your ini url, hold down the Ctrl (or Command key on a Mac) key and right-click on the drop down list:

READY?

When you have your url ready, send me an email at: troy.wolbrink@ccci.org. Tell me the NAME and URL in the email. Once I add you to the official list, TntMPD will be updated immediately.

How can I add integration for a newsletter service?

Troy Wolbrink — Wed, 18 Sep 2013 19:49:21 GMT

Revision 1 posted to Frequently Asked Questions by Troy Wolbrink on 9/18/2013 7:49:21 PM

You need to host a simple text file on your site that describes to TntMPD what your various endpoints are. It's in the "ini" format. As an example, here's some actual endpoints:

[simple] http://www.chalkline.org/ini.txt
[advanced] http://www.prayerletters.com/tntmpd/integration.ini

The ini file has several sections ( //comments in blue should not be in actual file):

[APPLICATION]
MinimumVersion=3.0.17 // minimum version of TntMPD required
RecommendedVersion=3.0.17 // recommended version of TntMPD

[LetterService]
// if you move your query.ini url, you can put in a redirect here to update TntMPD
RedirectQueryIni=
// url to your logo (300x100)
LogoUrl=http://www.example.com/static/images/logo100.png
// url for new customer to learn about your service
AboutUrl=http://www.example.com/tntmpd

// for simple integration, just provide a url to TntMPD-specific instructions … done! … stop here
HowToOrderUrl=http://www.example.org/TNTMPDInstructions.pdf

// advanced: optional way to allow for authentication persistence via OAUTH access token
AccessTokenRequestUrl=https://www.example.com/tntmpd/authorize?tntdb=$TNTMPD_DATABASE$
AccessTokenCompleteUrl=https://www.example.com/tntmpd/authorize_callback

// advanced: optional endpoint for TntMPD to revoke access tokens
AccessTokenRevokeUrl=https://www.example.com/tntmpd/authorize_revoke?token=$ACCESS_TOKEN$

// advanced integration: provide url to upload CSV of partners
// return url to launch in user's default browser to complete order
CsvFieldNamesAreLocalized=FALSE
CsvUploadUrl=https://www.example.com/tntmpd/upload_file?v=1&ACCESS_TOKEN$

For simple integration, you can stop with "HowToOrderUrl". The integration will look like this:

For advanced integration, you must provide the "CsvUploadUrl". The integration will look like this:

AccessTokenRequestUrl
AccessTokenCompleteUrl

If you don't want to support an OAUTH access token, don't include any of the AccessToken* urls, and don't include $ACCESS_TOKEN$ in our CsvUploadUrl.

CsvUploadUrl

TntMPD will POST the current group as UTF-8 CSV text in the body of request.

If there is an error, the service should return:

HTTP 401 if access token is invalid and needs to be reaquired.
or HTTP status 200, with “ERROR” on first line of body, actual error message on 2nd line.

ERROR
Example error message

If successful, return either:

HTTP 200, with body of “LaunchBrowserUrl=xxxxxx”
or a standard HTTP redirect (HTTP 301/302/303 w/ Location header)

The user's default browser will then be launched with the url returned so they can complete the order.