Gorgias
Name the pages your team watches, such as a supplier's prices, a carrier's delivery times or your own return policy. SpecStream reads them every hour, day or week, and each change arrives in Gorgias as a ticket that shows the lines that changed. The rows of a Deep Search can also go to Gorgias as customers, each value with the page it was read from.
Install
- Create a SpecStream API key under Agents & API (opens in a new tab) in your workspace. Starting is free: new accounts get $10 of credit, no card.
- Install SpecStream from the Gorgias App Store.
- On the Gorgias page that opens, allow SpecStream access to your helpdesk. You land on the SpecStream page, which says Connected to your Gorgias account.
Gorgias signs you in with OAuth 2.0, so SpecStream never sees your Gorgias password. To come back to the SpecStream page later, open https://api.specstream.ai/apps/gorgias/ in the same browser. If it asks for your Gorgias account, type the name before .gorgias.com and click Connect to Gorgias.
Check pages on a schedule
Under Check pages on a schedule, paste your SpecStream API key and the pages to check, one address per line, up to 20. Pick how often: every hour, every day or every week. Click Start checking.
The first run records the pages, so it opens no ticket. From then on, each run reads every page again and compares it with the last run. A ticket comes when a page:
- changed its text,
- could no longer be read, or
- could be read again.
Your checks are listed under Page checks, each with its pages, how often it runs and the result of its last run. Click Remove to stop one. A check also stops after 3 failed runs in a row, for example when the API key is deleted or the balance is empty, and the list shows it as stopped. To start it again, add the pages again with a working key.
What a ticket shows
Each change is one ticket, sent as SpecStream from page-checks@specstream.ai and tagged specstream and page-change. The subject names the page:
- Page changed: the ticket shows the page's address and the lines it lost and gained since the last run.
- Page not read: the ticket shows the address and why it could not be read.
- Page readable again: the page can be read again after a failed run.
Send Deep Search rows
Under Send Deep Search rows to Gorgias customers, paste your SpecStream API key and the id of a Deep Search you ran, then click Send rows. The rows are written right after you click, up to 1000 a send.
Each row with a published email becomes a Gorgias customer, or matches the customer who already has that email. Its values appear on the customer sidebar next to every ticket from that customer, each with the page it was read from. A row without a published email is counted and not sent. No ticket is opened and no message is sent.
Rows sent lists each send with what it did: customers created, customers updated, and rows without a published email.
Permissions and data
The app asks Gorgias for the scopes openid, email, profile, offline and write:all. It uses them to open page change tickets and to create or update customers from Deep Search rows. It looks up customers only by a row's email, to match them, and it doesn't read your tickets or messages.
SpecStream keeps the API key of each page check encrypted, to read the pages on each run. The key of a Deep Search send is kept encrypted until the send ends, then deleted. See the privacy policy and security.
Cost
The app is free. Page checks are paid from the SpecStream balance of the API key, at $0.80 per 1,000 pages read. Every page in a check is read on each run, so 10 pages checked every day are about 300 pages a month. Reading the rows of a Deep Search you ran is not charged. See pricing and balance, quotes and billing.
Disconnect
On the SpecStream page, click Disconnect Gorgias. SpecStream gives back its access to your helpdesk and removes your page checks. Tickets and customer values already written stay in Gorgias. To stop the API key working everywhere, delete it under Agents & API (opens in a new tab). The other tools SpecStream works with are in Connect your tools. For help, email support@specstream.ai.