Signal CLI icon

Signal CLI

Send and receive Signal messages via signal-cli-rest-api

Actions24

Message → Send and Wait for Response

AI-generated

Summary

Send a Signal message to a specified recipient (phone number or group ID) and wait for a reply within a configurable maximum wait time.

Inputs

  • Recipient (required) — The phone number in E.164 format or group ID (starting with 'group.') to send the message to and wait for a response from. Note that incoming messages from other conversations during the wait period will be consumed and ignored.
  • Message (required) — The text body of the Signal message to send.
  • Max Wait Time (Seconds) — The maximum time in seconds to wait for a reply message from the recipient before timing out. Defaults to 60 seconds.

Output shape

A single JSON object representing the received reply message matching the recipient criteria, as received from the Signal message stream.

The operation sends the message, then opens a WebSocket stream to listen for incoming messages. It resolves with the first reply received from the specified recipient (or group) within the max wait time. If no reply is received before timeout, it throws an error. Messages from other conversations or recipients during the wait period will be ignored and consumed.

Examples

Example 1: Send a message to +12025551234 and wait up to 90 seconds for a reply.

Recipient: '+12025551234', Message: 'Hello, please reply.', Max Wait Time: 90

Links

Discussion