Attentive

attentive is a mobile messaging platform for sms and email campaigns connecting it to chord brings your subscribers, message sends, and engagement events into your warehouse, so sms and email performance sits next to your orders, sessions, and other paid channels to connect, you create an app in attentive, generate an api key, and share the key with chord the steps below cover all three attentive is webhook only attentive does not offer an api to read your message history it only pushes events out as they happen, through webhooks that has one consequence worth planning around chord can only capture attentive events from the day your webhook is registered forward sends, clicks, and opt ins from before that date are not retrievable through the api and will not appear in your warehouse if you need historical subscriber data, attentive can export subscriber details for a segment from its own ui as a one time file ask your chord contact if you want that loaded alongside the live event feed generate an attentive api key you need an attentive user with access to the integrations page if you cannot see it, ask your attentive account admin log in to attentive go to integrations click + create app in the top right set app name to chord set contact email to your own email address under permissions , every api starts at no access set webhooks to write and leave the rest at no access click create the copy api key modal appears click copy , then paste the key somewhere safe before you close the modal attentive shows the api key only once attentive's own wording "this is the only time you will be able to copy this api key " if you close the modal without copying it, regenerate the key from the app on the integrations page and copy the new one attentive offers only no access or write for each api there is no read only level, so write on webhooks is the minimum that works turn on event webhooks the key alone is not enough the app also has to be allowed to send events on the integrations page, select the app you just created open the settings tab, then the webhooks tab set event webhook status to on under subscribe to event notifications , select subscription webhook chord registers the specific events it needs once it has your key you do not pick events yourself share the key with chord send the key to your chord contact or to help\@chord co mailto\ help\@chord co over your agreed secure channel do not put it in a plain email or a public slack channel treat it like a password anyone holding it can send messages from your attentive account chord verifies the key with a single authenticated call to attentive, registers the webhook, and confirms back to you events start arriving from that point the key is encrypted at rest and is never shown again in the chord ui what chord receives once the webhook is live, chord captures these events as they happen subscriptions sms and email opt ins and opt outs sends sms and email messages sent, with message and campaign identifiers engagement email opens, and link clicks on both sms and email inbound replies your subscribers send back over sms attributes custom subscriber attributes as they are set troubleshooting chord says the key is invalid confirm you copied the full value from the modal with no missing characters and no trailing space if you regenerated the key in attentive after sending it, send the new one the key works but no events arrive check the app on attentive's integrations page webhooks must be write , and event webhook status must be on under settings then webhooks changing either takes effect without a new key i connected today where is last quarter's data? it does not exist to fetch see the webhook only section above nothing before your webhook registration date is available through the attentive api do attentive api keys expire? no a key stays valid until you regenerate it or delete the app how do i rotate the key? regenerate it on the app on attentive's integrations page, copy the new value, and send it to chord the old key stops working the moment you regenerate, so events pause until chord has the new one tell your chord contact before you rotate so the gap stays short my attentive plan has no integrations page api access is not enabled on every attentive plan contact attentive support to turn it on, then start at step 1 stuck on a step? email help\@chord co mailto\ help\@chord co with the exact error text and we will trace it