We are writing to inform you that several fields, mutations, queries, and types in our GraphQL API and Zapier integration have been deprecated and will be replaced with their equivalent after May 21, 2023.

GraphQL API

• The argument id has been renamed to projectId in project query.

• The field creationTime has been renamed to createdAt.

• The field posts in Project type has been renamed to publications.

• The field updateTime has been renamed to updatedAt.

• The mutation named createPost has been renamed to createPublication.

• The mutation named deletePost has been renamed to deletePublication.

• The mutation named updatePost has been renamed to updatePublication.

• The query named post has been renamed to publication.

Zapier Integration

• The output field with the key creationTime has been renamed to createdAt.

• The output field with the key updateTime has been renamed to updatedAt.

• The output field with the key publicationTime has been renamed to publishedAt.

Please make sure to update your code or integrations to reflect these changes to avoid any disruptions.

If you have any questions or concerns, don’t hesitate to leave a comment or contact us directly.

Have a great holiday season! 🎄

Today, we're introducing new ways to retrieve and subscribe to publication comments so that you can easily include feedback you receive in your existing workflows or pipelines.

These new features complement the existing notification system, which sends an email to all Noticeable project collaborators who have opted to receive notifications whenever a publication comment is authored by one of your users.

The first addition is a new Zapier trigger that, once configured with a Zap, allows you to subscribe to publication comments and receive instant comment payloads that you can forward, handle, and/or process with any of the 5000+ other Zapier integrations:

The second change is the addition of new queries and fields in our GraphQL API to retrieve publication comments:

• We've added a query to list all comments in a given project:

  publicationComments(projectId: ID!): PublicationCommentConnection

• We've added a query that returns publication comments for a given project and comment identifier:

  publicationComment(projectId: ID!, commentId: ID!): PublicationComment

• The Publication type now includes an optional comments field that can be used to list comments for the publication in question.

Sample queries are available on our playground

https://playground.noticeable.io/?token=YOUR_API_TOKEN

You will also notice that all post-related mutations, queries, and types have been deprecated and renamed to publication. Another announcement about these changes will follow in the next few days, but don't be afraid of deprecations - they will remain for at least 4 months before being removed.

• We now support proxying some Noticeable endpoints in Newspages and Widgets for advanced use cases.

• We added 2 new event types to our JS SDK: respectively widget:header:link:clicked and widget:publication_summary:clicked to better track specific click events on Noticeable Widgets.

• A bug preventing updating the avatar of a publication author using the GraphQL API has been fixed.

• A caching issue leading to incorrect avatar images displayed for some publications has been fixed.

A new option has been added to send a copy of any publication email to you or all project collaborators, in 2 clicks. That’s a great way to check how such emails render in your mailbox before sending them to a wider audience.

You will find the option while editing a publication, in step 3 “Summary”:

Upon clicking on the preview link, a dialog appears to select the recipient and customize the prefix to use for the email subject. You just need to click on “Send” to confirm sending a preview email:

It is already possible to customize SEO tags per Newspage publication. Today, you can do the same thing for your Newspage home page.

You can define a custom title page, description, and canonical URL. To improve the display and usability of your links on social media you can even set a custom Open Graph and Twitter Card title, description, and image.

To access the options, open a project on the Noticeable dashboard, click on “Newspage” in the left navigation and scroll down to the new subgroup entitled “Search Engine Optimization (SEO)”:

• Disposable email addresses are no longer accepted upon email subscriptions. For this purpose, we created an open source project aggregating disposable email domains daily. Contributions and stars on Github are welcome ;)

• Project administrators have a new option on the Noticeable dashboard to resend a confirmation email to subscribers who have a non-verified email address when double opt-in is used.

• We added options to easily configure Newspage analytics collection using Cloudflare or Fathom, in addition to Google Analytics which is known for privacy issues.

• We fixed an issue preventing metrics collection on email subscribers created before the email feature preview was available.

• When you hover the relative publication date and time of a publication from the publication list on the Noticeable dashboard, a tooltip showing the absolute date and time is now displayed.

• When you open the sidebar to get details about an email dispatch, it displays the recipient email address if the dispatch is about an email subscription confirmation, and the publication ID if the dispatch is related to a publication.

• When a publication is duplicated, the user who performs the action is now set as the author of the publication.

• There is a new option in Newspage settings (Newspage > Customization > Display a search form) to remove the search form from your page.

• The search form on Newspages is now automatically submitted when the input field is focused out.

We’re proud to announce that you can now configure a custom MAIL FROM domain for emails sent by Noticeable. This helps improve deliverability and trust.

The configuration requires a few steps:

1. Click on “Emails” in the left navigation on the Noticeable dashboard.

2. Open the “Email domains” settings group and click “Add domain”.

3. In the dialog that appears enter your company email domain (e.g. acme.com) and click “Continue”.

4. At this stage, you are asked to add a set of DNS records to your domain’s DNS provider. These records are required to prove that you own the domain. Once done, click “Verify”.

Upon verification, your domain is automatically activated and emails you send now appear as coming from your company domain:

Note that Noticeable follows industry standards and once the configuration is completed, your emails are authenticated, thus passing DMARC and SPF verifications.

• Added options to select whether you want to track links and/or opens (both are enabled by default) for emails sent by Noticeable:

  

• Click counts on CTA buttons embedded in emails sent by Noticeable are now collected appropriately.

• Double opt-int subscriptions is the default. Switching to single-opt for subscriptions now requires to be on the Business plan or above.

• Fixed a bug preventing organizations on the Free, Starter and Growth plan to update some basic widget settings without upgrading to the Business plan.

• Similarly to draft publications, metrics for scheduled publications are no longer collected until the publication time is in the past.

Newspages now include a search field that enables full-text search. You can easily find publications based on your own terms. Search applies to publications’ author name, content, and title.

Note that you can combine search terms with label selection to further filter results.

Besides, all sentences related to the new search feature are fully customizable from the Noticeable dashboard:

1. Select Newspage on the left navigation.

2. Open the Phrases settings group.

3. Click the Search category and apply the changes you need: