Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt

Use this file to discover all available pages before exploring further.

Server path: /unipile-messaging | Type: Application | PCID required: Yes

Tools

ToolDescription
unipile_messaging_add_reactionAdd a reaction to a message
unipile_messaging_delete_chatDelete a chat
unipile_messaging_delete_messageDelete a message
unipile_messaging_forward_messageForward a message
unipile_messaging_get_attendee_by_idRetrieve an attendee
unipile_messaging_get_attendee_profile_pictureDownload a chat attendee picture
unipile_messaging_get_chatRetrieve a chat
unipile_messaging_get_messageRetrieve a message
unipile_messaging_get_message_attachmentRetrieve an attachment from a message
unipile_messaging_list_all_attendeesList all attendees
unipile_messaging_list_all_chatsList all chats
unipile_messaging_list_all_messagesList all messages
unipile_messaging_list_attendeesList all attendees from a chat
unipile_messaging_list_chat_messagesList all messages from a chat
unipile_messaging_list_chats_by_attendeeList all 1to1 chats for a given attendee
unipile_messaging_list_messages_by_attendeeList all messages for a given attendee
unipile_messaging_patch_chatPerform an action on a given chat
unipile_messaging_patch_messageEdit a message
unipile_messaging_send_message_in_chatSend a message in a chat
unipile_messaging_start_new_chatStart a new chat
unipile_messaging_sync_chat_historySynchronize a conversation from its beginning

unipile_messaging_add_reaction

Add a reaction to a message Parameters:
ParameterTypeRequiredDefaultDescription
message_idstringYesThe id of the message to react to.
reactionstringYesThe emoji to react with (native emoji, e.g. ).

unipile_messaging_delete_chat

Delete a chat Parameters:
ParameterTypeRequiredDefaultDescription
chat_idstringYesThe id of the chat to delete.

unipile_messaging_delete_message

Delete a message Parameters:
ParameterTypeRequiredDefaultDescription
message_idstringYesThe id of the message to delete.

unipile_messaging_forward_message

Forward a message Parameters:
ParameterTypeRequiredDefaultDescription
message_idstringYesThe id of the message to forward.
chat_idstringYesThe id of the chat to forward the message to.

unipile_messaging_get_attendee_by_id

Retrieve an attendee Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe id of the wanted attendee.
account_idstringNoA filter to target items related to a certain account.

unipile_messaging_get_attendee_profile_picture

Download a chat attendee picture Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe id of the attendee. Use a chat id to get the picture of a group chat.

unipile_messaging_get_chat

Retrieve a chat Parameters:
ParameterTypeRequiredDefaultDescription
account_idstringNoMandatory if the chat ID is a provider ID.
chat_idstringYesThe Unipile or provider ID of the chat.

unipile_messaging_get_message

Retrieve a message Parameters:
ParameterTypeRequiredDefaultDescription
message_idstringYesThe id of the message to retrieve.

unipile_messaging_get_message_attachment

Retrieve an attachment from a message Parameters:
ParameterTypeRequiredDefaultDescription
attachment_idstringYesThe id of the wanted attachment.
message_idstringYesThe id of the message to which the attachment is linked.

unipile_messaging_list_all_attendees

List all attendees Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoA cursor for pagination purposes. To get the next page of entries, you need to make a new request and fulfill this field with the cursor received in the preceding request. This process should be repeated until all entries have been retrieved.
limitintegerNoA limit for the number of items returned in the response. The value can be set between 1 and 250.
account_idstringNoA filter to target attendees related to a certain linked account. The id of the account targeted.

unipile_messaging_list_all_chats

List all chats Parameters:
ParameterTypeRequiredDefaultDescription
unreadbooleanNoWhether you want to get either unread chats only, or read chats only.
cursorstringNoA cursor for pagination purposes. To get the next page of entries, you need to make a new request and fulfill this field with the cursor received in the preceding request. This process should be repeated until all entries have been retrieved.
beforestringNoA filter to target items created before the datetime (exclusive). Must be an ISO 8601 UTC datetime (YYYY-MM-DDTHH:MM:SS.sssZ).
afterstringNoA filter to target items created after the datetime (exclusive). Must be an ISO 8601 UTC datetime (YYYY-MM-DDTHH:MM:SS.sssZ).
limitintegerNoA limit for the number of items returned in the response. The value can be set between 1 and 250.
account_typestringNoA filter to target items related to a certain provider.
account_idstringNoA filter to target items related to a certain account. Can be a comma-separated list of ids.

unipile_messaging_list_all_messages

List all messages Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoA cursor for pagination purposes. To get the next page of entries, you need to make a new request and fulfill this field with the cursor received in the preceding request. This process should be repeated until all entries have been retrieved.
beforestringNoA filter to target items created before the datetime (exclusive). Must be an ISO 8601 UTC datetime (YYYY-MM-DDTHH:MM:SS.sssZ).
afterstringNoA filter to target items created after the datetime (exclusive). Must be an ISO 8601 UTC datetime (YYYY-MM-DDTHH:MM:SS.sssZ).
limitintegerNoA limit for the number of items returned in the response. The value can be set between 1 and 250.
sender_idstringNoA filter to target messages received from a certain sender. The id of the sender targeted.
account_idstringNoA filter to target messages received in a certain linked account. The id of the account targeted.

unipile_messaging_list_attendees

List all attendees from a chat Parameters:
ParameterTypeRequiredDefaultDescription
chat_idstringYesThe id of the chat related to requested attendees.

unipile_messaging_list_chat_messages

List all messages from a chat Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoA cursor for pagination purposes. To get the next page of entries, you need to make a new request and fulfill this field with the cursor received in the preceding request. This process should be repeated until all entries have been retrieved.
beforestringNoA filter to target items created before the datetime (exclusive). Must be an ISO 8601 UTC datetime (YYYY-MM-DDTHH:MM:SS.sssZ).
afterstringNoA filter to target items created after the datetime (exclusive). Must be an ISO 8601 UTC datetime (YYYY-MM-DDTHH:MM:SS.sssZ).
limitintegerNoA limit for the number of items returned in the response. The value can be set between 1 and 250.
sender_idstringNoA filter to target messages received from a certain sender. The id of the sender targeted.
chat_idstringYesThe id of the chat related to requested messages.

unipile_messaging_list_chats_by_attendee

List all 1to1 chats for a given attendee Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoA cursor for pagination purposes. To get the next page of entries, you need to make a new request and fulfill this field with the cursor received in the preceding request. This process should be repeated until all entries have been retrieved.
beforestringNoA filter to target items created before the datetime (exclusive). Must be an ISO 8601 UTC datetime (YYYY-MM-DDTHH:MM:SS.sssZ).
afterstringNoA filter to target items created after the datetime (exclusive). Must be an ISO 8601 UTC datetime (YYYY-MM-DDTHH:MM:SS.sssZ).
limitintegerNoA limit for the number of items returned in the response. The value can be set between 1 and 250.
account_idstringNoA filter to target items related to a certain account. Can be a comma-separated list of ids.
attendee_idstringYesThe Unipile ID OR provider_id of the attendee. Can be a comma-separated list of multiple ids.

unipile_messaging_list_messages_by_attendee

List all messages for a given attendee Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoA cursor for pagination purposes. To get the next page of entries, you need to make a new request and fulfill this field with the cursor received in the preceding request. This process should be repeated until all entries have been retrieved.
beforestringNoA filter to target items created before the datetime (exclusive). Must be an ISO 8601 UTC datetime (YYYY-MM-DDTHH:MM:SS.sssZ).
afterstringNoA filter to target items created after the datetime (exclusive). Must be an ISO 8601 UTC datetime (YYYY-MM-DDTHH:MM:SS.sssZ).
limitintegerNoA limit for the number of items returned in the response. The value can be set between 1 and 250.
account_idstringNoA filter to target items related to a certain account. Can be a comma-separated list of ids.
sender_idstringYesThe Unipile ID OR provider_id of the attendee.

unipile_messaging_patch_chat

Perform an action on a given chat Parameters:
ParameterTypeRequiredDefaultDescription
chat_idstringYesThe id of the chat to be patched
actionstringNoThe action to perform on the chat: - setReadStatus: (WhatsApp & LinkedIn only) Set the read status of the chat. - setMuteStatus: (WhatsApp & LinkedIn only) Set the mute status of the chat. - setArchiveStatus: (WhatsApp only) Set the archive status of the chat. - setPinnedStatus: (WhatsApp only) Set the pinned status of the chat. - addParticipant: (WhatsApp & Telegram only) Add a participant to the group chat. The account owner must have the Add other members permission in the group. Provide the provider ID as value, for example 334455667788@s.whatsapp.net for WhatsApp, or a Telegram user ID, username, or phone number for Telegram. - removeParticipant: (WhatsApp & Telegram only) Remove a participant from the group chat. Provide the provider ID as value, for example 334455667788@s.whatsapp.net for WhatsApp, or a Telegram user ID, username, or phone number for Telegram. - setLabel: (WhatsApp only) Add a label to the chat. If the label does not exist, it will be created and then assigned. - getInviteLink: (WhatsApp & Telegram only) Generate or retrieve the full group invite link. The account owner must have the required invite permissions in the group.
valueobjectNoRequired for every action except getInviteLink. Use a boolean for status actions and a string for participant or label actions.

unipile_messaging_patch_message

Edit a message Parameters:
ParameterTypeRequiredDefaultDescription
message_idstringYesThe id of the message to edit.
textstringNoThe updated text of the message. For media messages, this is used as the updated caption when supported by the provider. On WhatsApp, edits may be rejected after an indicative 15-minute window following the original send time. On LinkedIn Classic, edits are only possible within the first 60 minutes after the message is sent.

unipile_messaging_send_message_in_chat

Send a message in a chat Parameters:
ParameterTypeRequiredDefaultDescription
chat_idstringYesThe id of the chat where to send the message.
account_idstringNoAn account_id can be specified to prevent the user from sending messages in chats not belonging to the account.
attachmentsstring[]NoThe attachments value
quote_idstringNoThe id of a message to quote. The id of the message to quote / reply to.
textstringNoThe text value
thread_idstringNoOptional and for Slack’s messaging only. The id of the thread to send the message in.
typing_durationstringNo(WhatsApp only) Set a duration in milliseconds to simulate a typing status for that duration before sending the message.
video_messagestringNo(Linkedin) A file to send as video message. WhatsApp: use attachments field.
voice_messagestringNo(Linkedin | WhatsApp) A file to send as voice message. WhatsApp: prefer .mp3 or .m4a. Linkedin: prefer .m4a. Instagram: use the attachment field and prefer .m4a. Telegram: use the attachment field.

unipile_messaging_start_new_chat

Start a new chat Parameters:
ParameterTypeRequiredDefaultDescription
account_idstringYesAn Unipile account id.
attachmentsstring[]NoThe attachments value
attendees_idsstring[]YesOne or more attendee provider ID. For instagram, please use the ‘provider_messaging_id’. For LinkedIn users, use a provider_id starting with: ACo for classic, ACw for Sales Navigator, AE for Recruiter. For LinkedIn company messaging, please use the ‘messaging_id’. For WhatsApp, please use ‘00000000@s.whatsapp.net’.
linkedinobjectNoExtra fields for Linkedin products
subjectstringNoAn optional field to set the subject of the conversation.
textstringNoThe message that will start the new conversation. With LinkedIn recruiter, a range of HTML tags can be used directly in the body of the message to enhance the presentation. The supported tags are <strong> for bold text, <em> for italic text, <a href=“www.my-link.com”> for external links, <ul> for unordered lists, <ol> for ordered lists and <li> for list items. Tags can be nested into each other if necessary.
video_messagestringNo(Linkedin) A file to send as video message. WhatsApp: use attachments field.
voice_messagestringNo(Linkedin | WhatsApp) A file to send as voice message. WhatsApp: prefer .mp3 or .m4a. Linkedin: prefer .m4a. Instagram: use the attachment field and prefer .m4a. Telegram: use the attachment field.

unipile_messaging_sync_chat_history

Synchronize a conversation from its beginning Parameters:
ParameterTypeRequiredDefaultDescription
chat_idstringYesThe id of the chat to be synced.