Method say

src/wechaty/user/contact.py:312–385

say something to contact, which can be text, image, file, contact, url Note: Its implementation depends on the puppet, so if you want to use this method, please check [Puppet](https://github.com/wechaty/wechaty/wiki/Puppet#3-puppet-compatible-table). Args:

(self, message: Union[str, Message, FileBox, Contact, UrlLink, MiniProgram]
                  )

        return 'Contact <%s> <%s>' % (self.contact_id, identity)

    async def say(self, message: Union[str, Message, FileBox, Contact, UrlLink, MiniProgram]
                  ) -> Optional[Message]:
        """say something to contact, which can be text, image, file, contact, url

        Note:
            Its implementation depends on the puppet, so if you want to use this method, please check
            [Puppet](https://github.com/wechaty/wechaty/wiki/Puppet#3-puppet-compatible-table).

        Args:
            message: the message object to be sended to contact
        
        Examples:
            >>> contact = Contact.load('contact-id')
            >>> await contact.say('hello')
            >>> await contact.say(FileBox.from_file('/path/to/file'))
            >>> await contact.say(contact)
            >>> await contact.say(UrlLink('https://wechaty.js.org'))

            >>> # the data format of mini program should pre-stored
            >>> await contact.say(MiniProgram('username', 'appid'))

        Returns:
            Message: if the message is send successfully, return the message object, otherwise return None 
        """
        if not message:
            log.error('can"t say nothing')
            return None

        if not self.is_ready():
            await self.ready()

        # import some class because circular dependency
        from wechaty.user.url_link import UrlLink   # pylint: disable=import-outside-toplevel

        if isinstance(message, str):
            # say text
            msg_id = await self.puppet.message_send_text(
                conversation_id=self.contact_id,
                message=message
            )
        elif isinstance(message, Contact):
            msg_id = await self.puppet.message_send_contact(
                contact_id=message.contact_id,
                conversation_id=self.contact_id
            )

        elif isinstance(message, FileBox):
            msg_id = await self.puppet.message_send_file(
                conversation_id=self.contact_id,
                file=message
            )

        elif isinstance(message, UrlLink):
            # use this way to resolve circulation dependency import
            msg_id = await self.puppet.message_send_url(
                conversation_id=self.contact_id,
                url=json.dumps(dataclasses.asdict(message.payload), ensure_ascii=False)
            )