Use this method to write a single answer into the Echo database for the survey connected with the Encrypted ID number submitted.
P1=Encrypted ID of a valid, open survey
This can be used if you would like to present a survey to your users without using Echo - but need to write the results of the survey's questions into Echo directly.
Currently, this only supports RADIO and COMMENT questions.
P1 must be the encrypted ID number of a valid survey - for example, 0189C286-DC73-4E20-97CD-8E5BBE42F253. Use the survey_request tool to create a new survey record and receive the encrypted ID for that record.
P1 must match a survey that is still open (i.e., has not expired) and is not yet complete.
P2 is a number matching the question number you would like to write the answer to - it must be a valid question number for the survey connected to the encrypted ID you submit.
For example, to write the answer to question 1 pass P2=1.
P3 is the answer you would like to write. It is either a number or a string - but this must match the question type of the survey and question number being submitted. Currently, only RADIO (select one option) or COMMENT question types can be submitted.
For example, if Q1 of your survey read "Was your issue resolved?" and the first answer option was "yes" and the second was "no" you would write the number corresponding to the answer you would like to submit. If you want to submit "no" as the answer you would submit P2=1&p3=2 (question 1, answer 2).
If Q2 was a comment question like "Please explain why your issue was not resolved" you could write a string as P3, for example P2=2&p3=the representative was not helpful.
The value for P3 should be URL encoded - the above is simplified for readability.
This method may return one of many error messages:
- EncID not found or answer already exists
- Error: Survey Record Not Found
- Error: Survey Sent Record Not Found or Survey Already Completed
- Error: Survey Not Found
- Error: Survey May Be Expired
- Error: Survey Question Mismatch
- Error: Survey Question Detail Mismatch
Only one error message will be returned, even if the request matched many error situations.