remixz/messenger-bot

Add support for uploading files

Open

#22 opened on Jul 1, 2016

View on GitHub
 (3 comments) (0 reactions) (0 assignees)JavaScript (1,061 stars) (227 forks)batch import
enhancementhelp wantedstarter

Description

Facebook just recently added the ability to upload files (images, audio, videos, or a generic file) for a message, instead of having to specify a URL for an attachment.

They all share the same format of it being a multipart POST form, with the file being under the key of filedata. For our sendMessage / reply, we should have some sort of special key in the payload that accepts the same inputs as request does for multipart forms (https://github.com/request/request#forms), and is then added to the request as filedata.

Contributor guide

Tech stack
javascriptnodejs
Domain
backendapi
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
mostly clear
Prerequisites
Node.js basicsHTTP multipart forms
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
60
Research direction
The issue requests adding file upload capability to the sendMessage/reply methods using multipart POST forms. The existing library uses the 'request' module, which supports multipart forms via its 'formData' option. Research how to extend the payload to accept file inputs and modify the send function to conditionally use multipart. Refer to the linked Facebook API docs and the 'request' module documentation.