Skip to main content

Neumo Jury (API)

Use eCourtDate as your texting service in Neumo Jury. Quickly integrate Neumo Jury and eCourtDate to send text messages to your jurors from Neumo's ad-hoc form.

How It Works​

This is a unidirectional integration: Neumo Jury sends messages to eCourtDate, which dispatches them and tracks delivery. eCourtDate does not write back to Neumo Jury.

Prerequisites​

You will need the following before using this guide:

  • A Neumo Jury instance with the ability to modify configuration properties.
  • You must be a Super Admin user in eCourtDate.
  • Your eCourtDate agency must have at least one Agency Phone Number marked as the Primary.

Configuration Steps​

We recommend starting with a staging agency to test the integration initially.

  1. Log in to the eCourtDate Console.
  2. Click on APIs.
  3. Choose your customer profile in the top left.
  4. Create or view an API client:
    • To create a new client: fill in the Create API form (enter a name, choose the default region, which determines which agencies are available, then choose the default agency), and click Create. You will be redirected to the newly created API client.
    • To view an existing client: click the Edit button next to the API client's name.
Don't see your API client?

If an API client is not showing when you expect it to, verify that you are a Super Admin in the default agency configured for that API client. You can double-check your agencies on the Agencies page.

Demo Staging API Client Configuration

note

We recommend setting an email address for the Alert Contacts setting. This is used to send notifications of any potential issues related to the API client.

  1. Log in to your Neumo Admin > Configuration > Config Properties. Update the following configuration properties:
PropertyValue
eCourtDate-clientIdCopy and paste the Client ID from eCourtDate.
eCourtDate-clientSecretCopy and paste the Client Secret from eCourtDate. If the Client Secret is hidden, click the unlock icon to view.
eCourtDate-serverThe eCourtDate API host for your environment (see below).
eCourtDate-courtIdSet to FALSE.
textingServiceSet to ECOURTDATE.

For eCourtDate-server, use the host that matches your environment:

  • Staging: staging.api.ecourtdate.com
  • Production: your assigned region host, one of:
    • us-east.api.ecourtdate.com
    • us-south.api.ecourtdate.com
    • us-west.api.ecourtdate.com
    • us-texas.api.ecourtdate.com

Neumo eCourtDate Configuration

Neumo Jury Configuration Instructions

What to Expect​

Once the configuration is complete, you can send ad-hoc messages from Neumo Jury. After sending a message, you should expect:

  • Neumo Jury's delivery report should not show any errors or issues.
  • The eCourtDate API client shows the last active date and time instead of Not Active. If active, you can click the Logs button to view any requests.
  • A new outbound message should show in the eCourtDate agency dashboard.
  • If you upload an attachment in the ad-hoc form, you should see the file linked to the message in eCourtDate.

Troubleshooting​

If a message does not send or the API client stays inactive, work through these steps before opening a ticket:

  1. Check the API client's activity. In the Console under APIs, confirm the client's Last Active shows a recent date and time rather than Not Active. If it is not updating, requests are not reaching eCourtDate.
  2. Verify the configuration properties. Confirm eCourtDate-clientId, eCourtDate-clientSecret, and eCourtDate-server match the values in eCourtDate. The eCourtDate-server property should not include https://, trailing slashes, or spaces.
  3. Allow cached properties to refresh. Outdated configuration properties may be cached; wait a few minutes and try sending a message again.
  4. Restart Neumo. If the configuration is correct and you have waited over 15 minutes, try restarting the Neumo server.
  5. Review the logs. If the client is active, click the Logs button on the API client to inspect the request and response.

If you still cannot send a message, open a support ticket: sign in to the eCourtDate app (staging or production) under your Default Agency and click the tickets button in the bottom-right corner. Include the following so the support team can trace the request:

  • The API client you are using (its name from Console > APIs, never the client secret)
  • The request URL
  • The request body, with any secrets or tokens redacted
  • The response status code
  • The response body
  • The approximate time of the request

Best Practices​

To optimize message delivery, we recommend a few optional settings in eCourtDate.

General Settings​

In your eCourtDate agency, click Admin > Settings and update the settings below:

  • Default Message Delay: Set this to 0 so that outbound messages are not delayed.
  • Send Immediately: Enable this so that outbound messages are immediately dispatched.
  • Auto Run Lookups: Enable this so that phone numbers from Neumo Jury are automatically validated.
  • Auto Replace Links: Enable this so links in outbound messages are automatically replaced with a trackable portal link.
  • Auto Create Contacts: Enable this to track jurors who opt out by replying with a STOP message.
  • Default Message Subject: Configure a subject to be prepended to outgoing text messages. This setting supports merge tags.

For Auto Replace Links to work, you must configure a Portal in Admin > Portals. Once enabled, links in outbound messages will use the portal, and when clicked the user is automatically redirected to the original link. This helps minimize spam filters by ensuring carriers do not flag links as suspicious. When a portal link is clicked, you should see an OPEN status on the message with details of the device that clicked the link. To manage previously created redirects, go to Admin > Portals > Redirects.

We recommend using your own domain for portal links. Read our guide on how to configure a web domain.

Agency Phone Settings​

Under Admin > Settings, click Agency Phones, then click edit on your primary phone number.

  • Inbound Calls Auto Response: Set a message that will be played as audio when a juror calls the agency phone number.
  • Inbound Texts Auto Response: Set a reply message that will be sent automatically when a juror texts the agency phone number.
  • Auto-Forward Inbound Calls: Set a phone number to receive inbound calls automatically.
  • Auto-Forward Inbound Texts: Set multiple emails or phones to forward inbound texts to. If a phone number, the phone must be able to receive text messages.

You can test inbound agency phone settings in staging. Auto responses and forwarded messages are simulated in the dashboard. You can manage agency phone numbers under Admin > Settings > Agency Phones.

How to Configure Multi-Agency​

Neumo Jury will send ad-hoc messages to the default agency set in the eCourtDate API client. With multi-agency, each court location can use its own separate agency. This gives each agency a unique phone number with its own inbound auto-responses.

To use separate agencies per court location:

  1. In the eCourtDate API client, under Enabled Agencies, click to enable your desired agencies. Click Save to apply your changes.
  2. In the Neumo Jury configuration, set eCourtDate-courtId to TRUE.
  3. Log in to each eCourtDate agency, click Admin > Settings, and set the Agency Reference to match your Neumo Court ID. Click Save to apply your changes.

Agency Reference General Setting

Ensure the Agency Reference is also set in the default agency.

Once configured, you should expect outbound messages to use the agency based on the Court ID. The default agency will be used if the agency is not found.

How to Configure a Data Dashboard​

Create a data dashboard to track message performance in real time.

  1. Click Admin > Dashboards.

  2. In the Add Data Dashboard form:

    • Choose a Name.
    • Set the Status to Private.
    • Keep the Data Source as Messages.
    • Click Add.

    You'll be redirected to the newly created dashboard.

  3. (Optional) If you are using multi-agencies, click the Agencies button, then choose additional agencies to include in the dashboard. After making any changes, click Save.

  4. Click Dashboard Link, then click Messages below the map. You should see any messages for each enabled agency automatically.

note

Staging agencies do not sync data with the dashboards. To simulate what a dashboard could look like, enable the Simulate Data option when editing a dashboard.

Supported Merge Tags​

When sending outbound messages, the following merge tags are supported if configured on the Agency General Settings page. See the Merge Tags guide for the full reference.

Agency tags:

[AgencyName], [AgencyReference], [AgencyPhone], [AgencyEmail], [AgencyWebsite], [AgencyAddress], [AgencyCity], [AgencyState], [AgencyZip]

Date and time tags (based on when the message is created):

[DateToday], [DateNow], [TimeNow], [DateTomorrow], [DateYesterday], [Date12Hours], [DateNextWeek], [BusinessHours], [BusinessFromTime], [BusinessToTime], [BusinessDays], [NextBusinessDay]

tip

[RandomTag] can be used when testing so that messages are not flagged as duplicates.

Location tags (used if the message is linked to a location):

[Location], [LocationName], [LocationFullAddress], [LocationAddress], [LocationAddress2], [LocationCity], [LocationCounty], [LocationState], [LocationZip], [LocationLink], [LocationInstructions], [LocationPasscode], [LocationNotes], [LocationPhone], [LocationEmail], [LocationWebsite], [LocationDescription], [LocationBusinessHours]