Inbox commands
Find conversations, read messages, and send replies with explicit account IDs; inspect comments, reviews, and workflow runs.
Read the conversation before sending a reply. Inbox writes can contact real customers, so verify both the account and recipient before execution. Authenticate first.
First command
Get ACCOUNT_ID from zernio accounts:list, then list active conversations:
zernio inbox:conversations --accountId "$ACCOUNT_ID" \
--status active --limit 20 --prettyThe response contains data and pagination metadata. Copy the intended conversation's id into CONVERSATION_ID; confirm its participant and account before continuing.
Commands
| Task | Command | Effect |
|---|---|---|
| List conversations | zernio inbox:conversations --accountId "$ACCOUNT_ID" | Read |
| Inspect a conversation | zernio inbox:conversation "$CONVERSATION_ID" --accountId "$ACCOUNT_ID" | Read |
| Read messages | zernio inbox:messages "$CONVERSATION_ID" --accountId "$ACCOUNT_ID" --sortOrder desc | Read |
| Send a DM reply | zernio inbox:send "$CONVERSATION_ID" --accountId "$ACCOUNT_ID" --message "Thanks for reaching out." | Customer-visible write |
| Find posts with comments | zernio inbox:comments --accountId "$ACCOUNT_ID" | Read |
| Read a post's comments | zernio inbox:post-comments "$POST_ID" --accountId "$ACCOUNT_ID" | Read |
| Reply to a comment | zernio inbox:reply "$POST_ID" --accountId "$ACCOUNT_ID" --commentId "$COMMENT_ID" --message "Thank you!" | Public write |
| List reviews | zernio inbox:reviews --accountId "$ACCOUNT_ID" | Read |
| Reply to a review | zernio inbox:review-reply "$REVIEW_ID" --accountId "$ACCOUNT_ID" --message "Thank you!" | Public write |
| Inspect workflow runs | zernio workflows:list-executions "$WORKFLOW_ID" --limit 10 | Read |
IDs come from the relevant listing response, not from a guessed URL. Run a command with --help before adding attachments, templates, or platform-specific interactive payloads.
Read, reply, verify
With both IDs set from the listing, read the messages first:
zernio inbox:messages "$CONVERSATION_ID" --accountId "$ACCOUNT_ID" --sortOrder desc --prettyAfter approval of the recipient and exact text, send once and read again:
zernio inbox:send "$CONVERSATION_ID" --accountId "$ACCOUNT_ID" \
--message "Yes, we ship to Portugal."
zernio inbox:messages "$CONVERSATION_ID" --accountId "$ACCOUNT_ID" --sortOrder desc --prettyIf sending times out, inspect the conversation before sending again. A transport failure does not prove the message was not delivered.
More inbox workflows
| Need | CLI group | Reference |
|---|---|---|
| Customer records and fields | contacts:, customfields: | Contacts |
| Bulk messaging | broadcasts: | Broadcasts |
| Follow-up sequences | sequences: | Sequences |
| Comment-triggered actions | automations: | Comment automations |
| Triggered node graphs | workflows: | Workflows |
Find the exact subcommand in zernio --help. Creating or launching a broadcast, sequence, or workflow is a write and can affect multiple recipients.
Workflows
Use workflows:list-executions with the workflow ID to inspect runs. Add --status waiting to focus on waiting executions and --limit to bound the response.
How it behaves
- Conversation and message commands require different inputs.
inbox:messagesandinbox:sendrequire--accountIdeven when the conversation ID is known. - Messages default to oldest-first, up to 100 per page. Use
--sortOrder descto inspect recent replies, and follow returned cursors when reconciling older messages. - The CLI requests 20 conversations by default. Continue with
--cursorusingpagination.nextCursorwhilepagination.hasMoreis true. - A cross-account conversation list can include failures in
meta. Inspect them rather than interpreting a partial result as an empty inbox. - Platform permissions and messaging windows still apply. A saved Zernio credential does not grant every platform messaging capability.