channels_receive_message
Add an incoming message to a Pipedrive conversation with required fields like id, channel_id, sender_id, conversation_id, message, status, and created_at.
Instructions
Add an incoming message to a conversation in Pipedrive.
This endpoint requires the Messengers integration OAuth scope and the Messaging manifest ready for the Messaging app extension.
Required fields:
id: ID of the message
channel_id: ID of the channel the message was sent to
sender_id: ID of the message sender
conversation_id: ID of the conversation this message belongs to
message: Content of the message
status: Status of the message (e.g., sent, delivered, read)
created_at: When the message was created (ISO 8601 format)
Optional fields:
reply_by: When a reply is expected by (ISO 8601 format)
conversation_link: Link to the conversation in the provider system
attachments: Array of message attachments
Example: { "id": "e283f878-7ef9-4294-8e5c-04a7d003fd92", "channel_id": "a8aa4db0-91bb-4e90-b9c0-0c6291307e2f", "sender_id": "5d4bd467-d847-4088-ae43-0c7614233bab", "conversation_id": "063ffa46-831c-4027-a04c-b65e17f077b7", "message": "This is a message", "status": "sent", "created_at": "2022-03-01T07:58:35.449Z", "reply_by": "2022-03-01T07:58:35.449Z", "conversation_link": "http://my-server.com/conversations/063ffa46-831c-4027-a04c-b65e17f077b7", "attachments": [ { "id": "b0369d1d-6b6a-4293-88b9-e2924782d47e", "type": "image/png", "name": "Image Name", "size": 600, "url": "http://my-server.com/images/b0369d1d-6b6a-4293-88b9-e2924782d47e.png", "preview_url": "http://my-server.com/images/b0369d1d-6b6a-4293-88b9-e2924782d47e.preview.png" } ] }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ID of the message (required) | |
| channel_id | Yes | ID of the channel the message was sent to (required) | |
| sender_id | Yes | ID of the message sender (required) | |
| conversation_id | Yes | ID of the conversation this message belongs to (required) | |
| message | Yes | Content of the message (required) | |
| status | Yes | Status of the message (e.g., sent, delivered, read) (required) | |
| created_at | Yes | When the message was created in ISO 8601 format (required) | |
| reply_by | No | When a reply is expected by in ISO 8601 format | |
| conversation_link | No | Link to the conversation in the provider system | |
| attachments | No | Array of message attachments |